Gestire aziende e sviluppatori tramite Edge

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

Se vuoi avere un maggiore controllo sulle aziende e sugli sviluppatori che partecipano al tuo programma API monetizzato , ad esempio se vuoi creare aziende e sviluppatori interni a scopo di test , puoi creare aziende e sviluppatori manualmente con l'interfaccia utente di gestione e l'API.

Una considerazione fondamentale che determina se devi creare aziende e sviluppatori manualmente è se gli sviluppatori avranno bisogno o meno delle credenziali per accedere all'interfaccia utente di gestione, inviare le credenziali nelle chiamate all'API di gestione Edge o accedere a un portale per sviluppatori.

• Se gli sviluppatori di monetizzazione hanno bisogno delle credenziali di accesso per accedere all'interfaccia utente o all'API Edge, devono prima avere il proprio account amministratore Apigee.
• Se devi semplicemente creare sviluppatori di test che non hanno bisogno di credenziali (ad esempio, se vuoi effettuare chiamate API con sviluppatori di test fittizi), non sono necessari account Apigee.

Gestire gli sviluppatori di app utilizzando l'interfaccia utente

Crea, gestisci e attiva gli sviluppatori di app utilizzando l'interfaccia utente Edge, come descritto in Gestire gli sviluppatori di app. Dopo aver creato gli sviluppatori di app, puoi aggiungerli alle aziende, come descritto nelle sezioni seguenti.

Gestire le aziende utilizzando l'interfaccia utente

Crea, gestisci e attiva le aziende, come descritto nelle sezioni seguenti.

Esplorare la pagina Aziende

Accedi alla pagina Aziende, come descritto di seguito.

Aggiungere un'azienda

Per aggiungere un'azienda:

1. Accedi alla pagina Aziende.
2. Fai clic su + Azienda.
3. Inserisci i dettagli dell'azienda.

   I campi obbligatori sono:

   • Nome dell'azienda
   • Amministratore (l'utente che è l'amministratore principale dell'azienda )
   • Tipo di fatturazione

   A seconda della configurazione di fatturazione della monetizzazione, il tipo di fatturazione potrebbe essere impostato per impostazione predefinita su PREPAID o POSTPAID. Per ulteriori informazioni, consulta Configurare i tipi di fatturazione con pagamento anticipato e posticipato utilizzando l'API.

4. Aggiungi uno o più sviluppatori all'azienda.
   1. Nella sezione Sviluppatori, inserisci una stringa nel campo Aggiungi sviluppatore per visualizzare l'elenco degli sviluppatori che corrispondono alla stringa.
   2. Seleziona uno sviluppatore dall'elenco a discesa.
   3. Ripeti l'operazione per aggiungere altri sviluppatori all'azienda.
5. Aggiungi uno o più attributi personalizzati.
   1. Nella sezione Attributi personalizzati, fai clic su + Nuovo.
   2. Inserisci il nome e il valore dell'attributo personalizzato.
   3. Ripeti l'operazione per aggiungere altri attributi personalizzati all'azienda.
6. Fai clic su Crea azienda.

Attivare e disattivare un'azienda

Per attivare e disattivare un'azienda:

1. Accedi alla pagina Azienda.
2. Posiziona il cursore sull'azienda che vuoi attivare e abilita nel menu delle azioni.
   Disattiva l'opzione per disattivare l'azienda.

Modificare un'azienda

Per modificare un'azienda:

1. Accedi alla pagina Azienda.
2. Posiziona il cursore sull'azienda che vuoi modificare e fai clic su nel menu delle azioni.
3. Aggiorna i dettagli dell'azienda, se necessario.
4. Fai clic su Aggiorna azienda per salvare le modifiche.

Eliminare un'azienda

Per eliminare un'azienda:

1. Accedi alla pagina Aziende.
2. Posiziona il cursore sull'azienda che vuoi eliminare e fai clic su nel menu delle azioni.
3. Fai clic su Elimina per confermare l'operazione di eliminazione.

Gestire aziende e sviluppatori utilizzando l'API

L'utilizzo dell'API per gestire aziende e sviluppatori è descritto nelle sezioni seguenti.

Creare e aggiornare aziende e sviluppatori utilizzando l'API

Per gestire aziende e sviluppatori con l'API di gestione Edge, consulta le seguenti sezioni dell'API:

• Creare un'azienda
• Creare uno sviluppatore
  Nota: configura le informazioni di monetizzazione quando crei uno sviluppatore passando gli attributi personalizzati.
• Aggiungere o aggiornare gli sviluppatori dell'azienda
  Nota: facoltativamente, puoi assegnare un ruolo allo sviluppatore, anche se non è obbligatorio. Per visualizzare un elenco dei ruoli sviluppatore, consulta Recuperare i ruoli sviluppatore.
• Elencare la configurazione di monetizzazione per tutti gli sviluppatori o per un singolo sviluppatore
  Nota: definisci le informazioni di monetizzazione passando gli attributi personalizzati quando crei o aggiorni uno sviluppatore. Puoi visualizzare gli attributi personalizzati di monetizzazione impostati utilizzando l'API standard (non di monetizzazione) per elencare tutti gli sviluppatori o un singolo sviluppatore.

Gestire i ruoli sviluppatore utilizzando l'API

Puoi creare ruoli utilizzando le API di monetizzazione. In questo modo puoi stabilire i ruoli per i tuoi partner. Ad esempio, puoi stabilire i ruoli di amministratore e sviluppatore di applicazioni per un partner. Questi ruoli possono essere assegnati a dipendenti partner specifici.

Creare un ruolo sviluppatore

Per creare un ruolo sviluppatore, invia una richiesta POST a organizations/{org_name}/developer-roles. Quando effettui la richiesta, devi specificare nel corpo della richiesta il nome e la descrizione del ruolo e l'identificazione dell' organizzazione. Ad esempio:

$ curl -H "Content-Type:application/json" -X POST -d \
'{
   "name": "appDeveloper",
   "description": "App Developer",
   "organization": {
       "id": "{org_name}"
   }
 }' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \
-u email:password

Recuperare i ruoli sviluppatore

Per recuperare i ruoli sviluppatore, invia una richiesta GET a organizations/{org_id}/developer-roles. Ad esempio:

$ curl -H "Accept:application/json" -X GET \
"https:// api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developer-roles" \
-u email:password

La risposta dovrebbe essere simile alla seguente (viene mostrata solo una parte della risposta):

{
  "description" : "App Developer",
  "id" : "appdeveloper",
  "name" : "appDeveloper",
  "organization" : {
   ...
  }
}

Impostazioni di configurazione dei ruoli sviluppatore per l'API

Le seguenti opzioni di configurazione dei ruoli sviluppatore sono esposte all'API:

Recuperare l'aliquota fiscale per uno sviluppatore utilizzando l'API

Puoi ottenere l'aliquota fiscale corrente per uno sviluppatore inviando una richiesta GET a organizations/{org_name}/tax-engine. Quando effettui la richiesta, devi specificare l'identificazione dello sviluppatore come parametro di query. Ad esempio:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/tax-engine?developerId=dev7@myorg.com" \
-u email:password

La risposta dovrebbe essere simile alla seguente:

0.09

Eseguire altre attività specifiche per gli sviluppatori utilizzando l'API

Molte delle attività correlate alla monetizzazione che puoi eseguire per un'organizzazione, come la creazione di piani tariffari o la creazione di condizioni di notifica, puoi eseguirle anche per un singolo sviluppatore. Ad esempio, puoi creare un conto bancario per uno sviluppatore specifico o generare un report Entrate per uno sviluppatore specifico.

La tabella seguente elenca le attività specifiche per gli sviluppatori che puoi eseguire utilizzando le API di monetizzazione. La tabella elenca anche dove puoi trovare istruzioni dettagliate su come eseguire queste attività.