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. info

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

Se non esistono già, crea i prodotti API, i pacchetti API e i piani tariffari per gli sviluppatori di cui stai eseguendo la migrazione. Per ulteriori informazioni, consulta:
Pubblica i piani tariffari, come descritto in Pubblicare i piani tariffari.
Aggiungi i nuovi sviluppatori alla tua organizzazione, come descritto in Registrare gli sviluppatori di app.
Ricarica il saldo con pagamento anticipato per ogni sviluppatore, come descritto in Gestire i saldi dell'account con pagamento anticipato.
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 parammetro di query waivefees su true.

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 corrente delle transazioni e aggiorna tutti i contatori interni in base a 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 risorsa transactions e impostando la proprietà batchSize su 1000 nel corpo della richiesta.

La tabella seguente 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 o meno.

Proprietà	Descrizione	Predefinito	Obbligatorio?
`application`	ID dell'app sviluppatore.	N/D	Sì
`batchSize`	Numero di transazioni da 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: Norme di registrazione delle transazioni per il prodotto API. Vedi Configurare un criterio di registrazione delle transazioni. Piano tariffario attivo per il prodotto API. Consulta la sezione Configurare il piano tariffario con attributi personalizzati.	N/D	Sì
`product`	ID del prodotto API.	N/D	Sì
`type`	Deve essere impostato su `CHARGE` (il valore predefinito).	`CHARGE`	No

Per saltare i passaggi di convalida e impostare forzatamente il numero di transazioni, imposta il parammetro di query force su true (ad esempio, ?force=true). Per impostazione predefinita, ?force=false e i passaggi di convalida vengono eseguiti. Ad esempio, se uno sviluppatore con pagamento anticipato ha un saldo pari a zero e l'attività dell'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 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 dell'API è impostato su 0.1. Se moltiplicati tra loro, 125 * 0,1 fa 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 commissioni di configurazione o ricorrenti, puoi saltare questo passaggio. La chiamata alla risorsa transactions non influisce sulla configurazione o sulle commissioni 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, i relativi valori predefiniti e se sono richiesti 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`	Da impostare su `SETUPFEES` o `RECURRINGFEES`.	`CHARGE`	Sì

Per saltare i passaggi di convalida e addebitare forzatamente la commissione, 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 un sviluppatore con abbonamento prepagato ha un saldo pari a zero e l'attività sull'account è sospesa, la richiesta non andrà a buon fine durante la convalida.?force=false

Ad esempio, la seguente richiesta addebita una commissione di 10 $ allo sviluppatore abbonato al 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