Questa pagina è stata tradotta dall'API Cloud Translation.

Eseguire la migrazione degli sviluppatori alla monetizzazione

Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione Documentazione di Apigee X. Informazioni

Se hai già degli sviluppatori che devono eseguire la migrazione alla monetizzazione:

Crea prodotti API, pacchetti API e piani tariffari per gli sviluppatori a cui eseguire la migrazione, se non esistono già. Per ulteriori informazioni, consulta:
Pubblica i piani tariffari, come descritto in Pubblicazione dei piani tariffari.
Aggiungi i nuovi sviluppatori alla tua organizzazione, come descritto nell'articolo Registrare gli sviluppatori di app.
Ricarica il saldo prepagato per ogni sviluppatore, come descritto in Gestire l'account prepagato Saldi.
Accetta il piano tariffario, come descritto in Tasso di acquisto. i piani utilizzando l'API.
Nota: per rinunciare alle commissioni di configurazione, se uno sviluppatore è già stato addebitato, imposta la 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 ha transazioni esistenti, puoi saltare questa procedura passaggio.

La risorsa transactions inserisce una singola transazione che riflette utilizzo attuale delle transazioni e aggiorna tutti i contatori interni per riflettere questo nuovo valore.

Ad esempio, se lo sviluppatore ha effettuato 1000 chiamate all'API prima della migrazione, registrare l'attività corrente, puoi impostare l'utilizzo delle transazioni su 1000 chiamando transactions risorsa e impostazione della proprietà batchSize su 1000 in il corpo della richiesta.

La tabella seguente riassume le proprietà di configurazione che puoi specificare nella corpo della richiesta di impostare manualmente il numero di transazioni, i relativi valori predefiniti e se e non sono obbligatori.

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 la l'utilizzo delle transazioni. Il numero dell'attributo personalizzato nel messaggio deve essere specificato come un numero intero positivo o decimale (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 Configurare un di registrazione delle transazioni. Piano tariffario attivo per il prodotto API. Consulta Configurare piano tariffario con attributi personalizzati.	N/D	Sì
`product`	ID del prodotto API.	N/D	Sì
`type`	Deve essere impostato su `CHARGE` (che è l'impostazione predefinita).	`CHARGE`	No

Per saltare i passaggi di convalida e forzare l'impostazione del numero di transazioni, imposta il campo force parametro di query in true (ad es. ?force=true). Per impostazione predefinita, ?force=false e i passaggi di convalida sono eseguito. Ad esempio, se uno sviluppatore che ha scelto il pagamento anticipato ha un saldo pari a zero e non ha attività nell'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 il applicazione e prodotto API:

$ 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 specificata e prodotto basato su API. Nella richiesta, il campo batchSize è impostato su 125 e il valore per il primo attributo personalizzato definito per il prodotto API sia impostato su 0.1. Quando moltiplicati insieme, 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 di configurazione o ricorrenti necessarie, puoi addebita 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à stati addebitati costi di configurazione o ricorrenti, puoi saltare questo passaggio. La chiamata alla risorsa transactions non influirà sulla configurazione o le tariffe ricorrenti definite dal piano tariffario.

La tabella seguente riassume le proprietà di configurazione che puoi specificare nella richiedi all'organismo di addebitare manualmente una tariffa di configurazione o ricorrente per un piano tariffario, l'importo predefinito 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`	Tariffa 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 tariffa, imposta la query force su true (ad es. ?force=true). Per impostazione predefinita, ?force=false e i passaggi di convalida vengono eseguiti. Ad esempio, se un abbonamento prepagato lo sviluppatore ha un saldo pari a zero e l'attività sull'account viene sospesa se ?force=false: la richiesta avrà esito negativo durante la convalida.

Ad esempio, la seguente richiesta addebita una commissione di configurazione di 10 in dollari USA alla 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