Gestire aziende e sviluppatori tramite Edge

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

Se vuoi avere un maggiore controllo sulle aziende e sugli sviluppatori che partecipano alla tua monetizzazione API, ad esempio se vuoi creare aziende e sviluppatori interni per per scopi di test: puoi creare manualmente aziende e sviluppatori con l'interfaccia utente di gestione e API.

Una considerazione principale che determina se è necessario creare manualmente aziende e sviluppatori è se gli sviluppatori avranno bisogno o meno di credenziali per accedere all'interfaccia utente di gestione, invia le credenziali nelle chiamate all'API Edge Management oppure accedi al portale per gli sviluppatori.

• Se gli sviluppatori di monetizzazione necessitano di credenziali di accesso per accedere all'interfaccia utente o all'API Edge, devono prima disporre di Account amministratore Apigee.
• Se devi semplicemente creare sviluppatori di test che non hanno bisogno di credenziali (ad esempio, effettuare chiamate API con sviluppatori di test fittizi), nessun account Apigee obbligatorio.

Gestione degli sviluppatori di app tramite l'interfaccia utente

Creare, gestire e attivare 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.

Gestione delle aziende mediante l'interfaccia utente

Creare, gestire e attivare aziende, come descritto nelle sezioni seguenti.

Esplorazione della pagina Aziende

Accedi alla pagina Aziende, come descritto di seguito.

Aggiunta di 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 rappresenta l'azienda principale amministratore)
   • Tipo di fatturazione

   A seconda della configurazione di fatturazione della monetizzazione, il Tipo di fatturazione può essere impostato su PREPAID o POSTPAID. Per ulteriori informazioni, consulta Configurare i tipi di fatturazione prepagata e con pagamento 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 corrispondenti alla stringa.
   2. Seleziona uno sviluppatore dall'elenco a discesa.
   3. Ripeti la procedura 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 la procedura 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 dell'azienda.
2. Posiziona il cursore sull'azienda che vuoi attivare e attiva nel menu Azioni.
   Disattiva il pulsante di attivazione/disattivazione per disattivare l'azienda.

Modifica di un'azienda

Per modificare un'azienda:

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

Eliminazione di un'azienda

Per eliminare un'azienda:

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

Gestione di aziende e sviluppatori mediante l'API

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

Creazione e aggiornamento di aziende e sviluppatori tramite l'API

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

• Creare un'azienda
• Crea uno sviluppatore
  Nota: configura le informazioni sulla monetizzazione quando crei uno sviluppatore trasmettendo attributi personalizzati.
• Aggiungi o aggiorna gli sviluppatori aziendali
  Nota: se non è obbligatorio, puoi assegnare un ruolo allo sviluppatore anche se non è obbligatorio. Per ottenere un elenco per i ruoli sviluppatore, consulta l'articolo Recupero dei ruoli sviluppatore.
• Elencare le configurazioni della monetizzazione per tutti gli sviluppatori o per un singolo sviluppatore
  Nota: per definire le informazioni sulla monetizzazione, trasmetti attributi personalizzati quando creando o aggiorna uno sviluppatore. Puoi visualizzare gli attributi personalizzati per la monetizzazione impostati utilizzando l'API standard (non monetizzazione) per elencare tutti gli sviluppatori o singolo sviluppatore.

Gestione dei ruoli sviluppatore tramite l'API

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

Creazione di 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 del 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

Recupero dei ruoli sviluppatore in corso

Per recuperare i ruoli sviluppatore, invia una richiesta GET aorganization/{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 avere un aspetto simile al seguente (è mostrata solo una parte della risposta):

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

Impostazioni di configurazione del ruolo Sviluppatore per l'API

Le seguenti opzioni di configurazione del ruolo sviluppatore sono esposte all'API:

Recupero dell'aliquota fiscale per uno sviluppatore che utilizza 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 avere un aspetto simile a questo:

0.09

Esecuzione di altre attività specifiche dello sviluppatore utilizzando l'API

Molte delle attività relative alla monetizzazione che puoi svolgere per un'organizzazione, ad esempio: creare piani tariffari o condizioni di notifica, puoi anche eseguire sviluppatore. Ad esempio, puoi creare un conto bancario per uno specifico sviluppatore o generare report Entrate per uno sviluppatore specifico.

La tabella seguente elenca le attività specifiche dello sviluppatore che puoi eseguire utilizzando le API di monetizzazione. La tabella indica anche dove puoi trovare istruzioni dettagliate sul rendimento queste attività.