Questa pagina è stata tradotta dall'API Cloud Translation.

Eseguire la migrazione degli sviluppatori alla monetizzazione

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 su true.

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 su true (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 su 125 e il valore del primo attributo personalizzato definito per il prodotto API è impostato su 0.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` o `RECURRINGFEES`.	`CHARGE`	Sì

Per saltare i passaggi di convalida e addebitare forzatamente la tariffa, imposta il parametro di query force su true (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