Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
Se hai sviluppatori esistenti di cui devi eseguire la migrazione alla monetizzazione:
- Crea i prodotti API, i pacchetti API e i piani tariffari per gli sviluppatori di cui esegui la migrazione, se non esistono già. Per saperne di più, consulta:
- Pubblica i piani tariffari, come descritto nella sezione Pubblicazione dei piani tariffari.
- Aggiungi i nuovi sviluppatori all'organizzazione, come descritto nell'articolo Registrare gli sviluppatori di app.
- Ricaricare il saldo prepagato per ogni sviluppatore, come descritto in Gestire i saldi prepagati dell'account.
- Accetta il piano tariffario, come descritto in Acquistare piani tariffari utilizzando l'API.
Nota: per rinunciare alle tariffe di configurazione, se a uno sviluppatore è già stato addebitato un importo, imposta il parametro di query
waivefees
sutrue
. - Se uno sviluppatore di cui esegui 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 dispone di 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 da riflettere il nuovo valore.Ad esempio, se lo sviluppatore ha emesso 1000 chiamate all'API prima della migrazione, per acquisire l'attività attuale puoi impostare l'utilizzo delle transazioni su 1000 chiamando la risorsa
transactions
e impostando la proprietàbatchSize
su 1000 nel corpo della richiesta.La tabella riportata di seguito riassume 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 obbligatorie.
Proprietà Descrizione Predefinito Campo obbligatorio? application
ID dell'app sviluppatore.
N/A 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 o decimale positivo (fino a quattro cifre decimali). Non sono consentiti valori negativi.
L'attributo personalizzato deve essere definito in:
- Norme di registrazione delle transazioni per il prodotto API. Consulta la sezione Configurare un criterio di registrazione delle transazioni.
- Piano tariffario attivo per il prodotto API. Consulta Configurare il piano tariffario con attributi personalizzati.
N/A Sì product
ID del prodotto API.
N/A Sì type
Deve essere impostato su
CHARGE
(impostazione predefinita).CHARGE
No Per saltare i passaggi di convalida e impostare forzatamente il numero di transazioni, imposta il parametro di query
force
sutrue
(ad esempio,?force=true
). Per impostazione predefinita, vengono eseguiti?force=false
e i passaggi di convalida. Ad esempio, se uno sviluppatore prepagato ha un saldo pari a zero e l'attività sull'account viene 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 richiesta seguente imposta l'utilizzo delle transazioni su 12,5 per l'applicazione e il prodotto API specificati. Nella richiesta,
batchSize
è impostato su125
e il valore del primo attributo personalizzato definito per il prodotto API è impostato su0.1
. Se moltiplicati insieme, 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
- Se a uno sviluppatore non sono state addebitate le tariffe ricorrenti o di configurazione necessarie, puoi addebitare manualmente una tariffa 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 tariffe di configurazione o ricorrenti, puoi saltare questo passaggio. La chiamata della risorsa
transactions
non influirà sulla configurazione o sulle tariffe ricorrenti definite dal piano tariffario.La tabella seguente riassume le proprietà di configurazione che puoi specificare nel corpo della richiesta per addebitare manualmente una tariffa di configurazione o ricorrente per un piano tariffario, nonché i relativi valori predefiniti e se sono obbligatori o meno.
Proprietà Descrizione Predefinito Campo 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/A Sì developer
ID dello sviluppatore.
N/A Sì rate
Configurazione o tariffa ricorrente da addebitare.
N/A Sì ratePlan
ID del piano tariffario.
N/A Sì type
Da impostare su
SETUPFEES
oRECURRINGFEES
.CHARGE
Sì Per saltare i passaggi di convalida e addebitare forzatamente la tariffa, imposta il parametro di query
force
sutrue
(ad esempio,?force=true
). Per impostazione predefinita, vengono eseguiti?force=false
e i passaggi di convalida. Ad esempio, se uno sviluppatore prepagato ha un saldo pari a zero e l'attività sull'account viene sospesa, se?force=false
la richiesta non andrà a buon fine durante la convalida.Ad esempio, la seguente richiesta addebita una tariffa di configurazione di 10 in dollari statunitensi 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