Eseguire la migrazione degli sviluppatori alla monetizzazione

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Se hai sviluppatori esistenti di cui devi eseguire la migrazione alla monetizzazione:

  1. Crea i prodotti API, i pacchetti API e i piani tariffari per gli sviluppatori di cui stai eseguendo la migrazione, se non esistono già. Per saperne di più, consulta:
  2. Pubblica i piani tariffari, come descritto in Pubblicare i piani tariffari.
  3. Aggiungi i nuovi sviluppatori alla tua organizzazione, come descritto in Registrare gli sviluppatori di app.
  4. Ricarica il saldo prepagato per ogni sviluppatore, come descritto in Gestire i saldi degli account prepagati.
  5. Accetta il piano tariffario, come descritto in Acquistare piani tariffari utilizzando l'API.

    Nota: per rinunciare alle commissioni di configurazione, se a uno sviluppatore sono già state addebitate, imposta il waivefees parametro di query su true.

  6. Se uno sviluppatore di cui stai eseguendo la migrazione ha transazioni esistenti, puoi trasferire manualmente l'utilizzo delle transazioni utilizzando la seguente risorsa:
    /organizations/{org_name}/transactions, dove {org_name} è il nome dell'organizzazione.

    Nota: se uno sviluppatore non ha transazioni esistenti, puoi saltare questo passaggio.

    La risorsa transactions inserisce una singola transazione che riflette l' utilizzo attuale delle transazioni e aggiorna tutti i contatori interni in modo che riflettano questo nuovo valore.

    Ad esempio, se lo sviluppatore ha emesso 1000 chiamate all'API prima della migrazione, per acquisire l'attività corrente puoi impostare l'utilizzo delle transazioni su 1000 chiamando la transactions e impostando la batchSize su 1000 nel corpo della richiesta.

    La tabella seguente riepiloga le proprietà di configurazione che puoi specificare nel corpo della richiesta per impostare manualmente il numero di transazioni, i relativi valori predefiniti e se sono obbligatori o meno.

    Proprietà Descrizione Predefinito Obbligatorio?
    application

    ID dell'app sviluppatore.

    		 N/D Sì
    batchSize

    Numero di transazioni che vuoi trasferire.

    		 1 No
    custAttn

    Valore dell'attributo personalizzato utilizzato con batchSize per calcolare l' utilizzo delle transazioni.

    Il numero dell'attributo personalizzato nel messaggio deve essere specificato come valore intero positivo o decimale (fino a quattro cifre decimali). I valori negativi non sono consentiti.

    L'attributo personalizzato deve essere definito in:

    		 N/D Sì
    product

    ID del prodotto API.

    		 N/D Sì
    type

    Deve essere impostato su CHARGE (valore predefinito).

    		 CHARGE No

    Per saltare i passaggi di convalida e impostare forzatamente il numero di transazioni, imposta il force parametro di query su true (ad esempio, ?force=true). Per impostazione predefinita, ?force=false e i passaggi di convalida vengono eseguiti. Ad esempio, se uno sviluppatore prepagato ha un saldo pari a zero e l'attività dell'account è sospesa, se ?force=false la richiesta non andrà a buon fine durante la convalida.

    Ad esempio, la seguente richiesta imposta il numero di transazioni su 50 per l'applicazione e il prodotto API specificati:

    $ curl -H "Content-Type:application/json" -X POST -d \
'{ 
   "application":{
     "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b"
   },
   "product":{
     "id":"testproduct"
   },
   "batchSize":50
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
-u email:password

    La seguente richiesta imposta l'utilizzo delle transazioni su 12,5 per l'applicazione e il prodotto API specificati. Nella richiesta, batchSize è impostato su 125 e il valore per il primo attributo personalizzato definito per il prodotto API è impostato su 0.1. Se moltiplicati, 125 * 0,1 = 12,5.

    $ curl -H "Content-Type:application/json" -X POST -d \
'{ 
   "application":{
     "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b"
   },
   "product":{
     "id":"testproduct"
   },
   "batchSize": 125,
   "custAtt1" : 0.1
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
-u email:password
  7. Se a uno sviluppatore non sono state addebitate le commissioni di configurazione o ricorrenti necessarie, puoi addebitare manualmente una commissione di configurazione o ricorrente per un piano tariffario utilizzando la seguente risorsa:
    /organizations/{org_name}/transactions, dove {org_name} è il nome dell'organizzazione.

    Nota: se allo sviluppatore sono già state addebitate le commissioni di configurazione o ricorrenti, puoi saltare questo passaggio. La chiamata alla risorsa transactions non influirà sulle commissioni di configurazione o ricorrenti definite dal piano tariffario.

    La tabella seguente riepiloga le proprietà di configurazione che puoi specificare nel corpo della richiesta per addebitare manualmente una commissione di configurazione o ricorrente per un piano tariffario, i relativi valori predefiniti e se sono obbligatori o meno.

    Proprietà Descrizione Predefinito Obbligatorio?
    currency

    Valuta utilizzata per il piano tariffario. Specifica il codice ISO 4217 per la valuta, ad esempio usd per il dollaro statunitense o chf per il franco svizzero.

    		 N/D Sì
    developer

    ID dello sviluppatore.

    		 N/D Sì
    rate

    Commissione di configurazione o ricorrente da addebitare.

    		 N/D Sì
    ratePlan

    ID del piano tariffario.

    		 N/D Sì
    type

    Imposta su SETUPFEES o RECURRINGFEES.

    		 CHARGE Sì

    Per saltare i passaggi di convalida e addebitare forzatamente la commissione, imposta il force query parametro su true (ad esempio, ?force=true). Per impostazione predefinita, ?force=false e i passaggi di convalida vengono eseguiti. Ad esempio, se uno sviluppato prepagato ha un saldo pari a zero e l'attività dell'account è sospesa, se ?force=false la richiesta non andrà a buon fine durante la convalida.

    Ad esempio, la seguente richiesta addebita una commissione di configurazione di 10 dollari USA allo sviluppatore che ha sottoscritto il piano tariffario:

    $ curl -H "Content-Type:application/json" -X POST -d \
'{ 
   "developer":{
     "id":"dev1@myorg.com"
   },
   "currency":{
     "id":"usd"
   },
   "ratePlan":{
     "id":"mypackage_rateplan1"
   },   
   "rate":10,
   "type":"SETUPFEES"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
-u email:password