Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
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 utilizzando l'API e l'interfaccia utente di gestione.
Una considerazione principale che determina se è necessario creare manualmente società e sviluppatori è se gli sviluppatori avranno bisogno o meno di credenziali per accedere all'interfaccia utente di gestione, inviare le credenziali nelle chiamate all'API Edge Management o accedere a un portale per gli sviluppatori.
- Se gli sviluppatori della monetizzazione hanno bisogno di credenziali di accesso per accedere all'API o alla UI 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.
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. Una volta creati gli sviluppatori di app, puoi aggiungerli alle aziende, come descritto nelle sezioni seguenti.
Gestione delle aziende tramite l'interfaccia utente
Creare, gestire e attivare le aziende, come descritto nelle sezioni seguenti.
Esplorare la pagina Aziende
Accedi alla pagina Aziende, come descritto di seguito.
Perimetrale
Per accedere alla pagina Aziende utilizzando l'interfaccia utente Edge:
- Accedi ad apigee.com/edge.
- Seleziona Pubblica > Monetizzazione > Aziende nella barra di navigazione a sinistra.
Viene visualizzata la pagina Aziende.
Come evidenziato nella figura, la pagina Aziende consente di:
- Visualizzare informazioni di riepilogo relative a tutte le aziende, inclusi nome, ID di registrazione, numero di app registrate e chiavi API, tipo di fatturazione, numero di sviluppatori assegnati all'azienda e stato
- Aggiungere un'azienda
- Attivare o disattivare un'azienda
- Modificare un'azienda
- Eliminare un'azienda
- Cerca nell'elenco delle aziende
Classic Edge (private cloud)
Per accedere alla pagina Aziende utilizzando l'interfaccia utente classica di Edge:
- Accedi a
http://ms-ip:9000
, dove ms-ip è l'indirizzo IP o il nome DNS del nodo del server di gestione. - Seleziona Pubblica > Aziende nella barra di navigazione in alto.
Viene visualizzata la pagina Aziende.
- Visualizza l'elenco attuale delle aziende
- Gestisci un'azienda. In particolare, puoi aggiungere, attivare, modificare ed eliminare un'azienda.
- Visualizza il portale per gli sviluppatori collegato (solo Drupal 7)
Aggiunta di un'azienda
Per aggiungere un'azienda:
- Accedi alla pagina Aziende.
- Fai clic su + azienda.
- 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 della fatturazione per la monetizzazione, il tipo di fatturazione potrebbe essere impostato su
PREPAID
oPOSTPAID
per impostazione predefinita. Per ulteriori informazioni, consulta l'articolo Configurare i tipi di fatturazione prepagata e con pagamento posticipato utilizzando l'API. - Aggiungi uno o più sviluppatori all'azienda.
- Nella sezione Sviluppatori, inserisci una stringa nel campo Aggiungi sviluppatore per visualizzare l'elenco di sviluppatori che corrispondono alla stringa.
- Seleziona uno sviluppatore dall'elenco a discesa.
- Ripeti la procedura per aggiungere altri sviluppatori all'azienda.
- Aggiungi uno o più attributi personalizzati.
- Nella sezione Attributi personalizzati, fai clic su + Nuovo.
- Inserisci il nome e il valore dell'attributo personalizzato.
- Ripeti la procedura per aggiungere altri attributi personalizzati all'azienda.
- Fai clic su Crea azienda.
Attivazione e disattivazione di un'azienda
Per attivare e disattivare una società:
- Accedi alla pagina Azienda.
- Posiziona il cursore sull'azienda che vuoi attivare e abilita nel menu Azioni.
Disabilita l'opzione per disattivare l'azienda.
Modifica di un'azienda
Per modificare un'azienda:
- Accedi alla pagina Azienda.
- Posiziona il cursore sull'azienda da modificare e fai clic su nel menu Azioni.
- Aggiorna i dettagli dell'azienda, come richiesto.
- Fai clic su Aggiorna azienda per salvare le modifiche.
Eliminazione di un'azienda
Per eliminare un'azienda:
- Accedi alla pagina Aziende.
- Posiziona il cursore sull'azienda da eliminare e fai clic su nel menu delle azioni.
- Fai clic su Elimina per confermare l'operazione di eliminazione.
Gestione di aziende e sviluppatori che utilizzano l'API
L'utilizzo dell'API per gestire aziende e sviluppatori viene descritto nelle sezioni seguenti.
Creare e aggiornare aziende e sviluppatori che utilizzano l'API
Per gestire aziende e sviluppatori con l'API Edge Management API, consulta le seguenti sezioni dell'API:
- Creare un'azienda
- Crea uno sviluppatore
Nota: configura le informazioni sulla monetizzazione quando crei uno sviluppatore inserendo attributi personalizzati. - Aggiungere o
aggiornare sviluppatori aziendali
Nota: facoltativamente, puoi assegnare un ruolo allo sviluppatore, anche se non è obbligatorio. Per ottenere un elenco dei ruoli sviluppatore, consulta Recuperare i ruoli sviluppatore. - Elenca le configurazioni di monetizzazione per tutti gli sviluppatori o per un singolo sviluppatore
Nota: definisci le informazioni sulla monetizzazione inserendo attributi personalizzati durante la creazione o l'aggiornamento di uno sviluppatore. Puoi visualizzare gli attributi personalizzati di monetizzazione impostati utilizzando l'API standard (non per la monetizzazione) per elencare tutti gli sviluppatori o singoli sviluppatori.
Gestione dei ruoli sviluppatore tramite 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 quindi essere assegnati a dipendenti partner specifici.
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 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
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):
{ "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:
Nome | Descrizione | Predefinito | Campo obbligatorio? |
---|---|---|---|
name |
Il nome del ruolo sviluppatore. |
N/A | Sì |
description |
Una descrizione del ruolo sviluppatore. |
N/A | Sì |
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
Esecuzione di altre attività specifiche per sviluppatore utilizzando l'API
Molte delle attività relative alla monetizzazione che puoi eseguire per un'organizzazione, come creare piani tariffari o creare condizioni di notifica, possono essere eseguite 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 seguente tabella elenca le attività specifiche per sviluppatore che puoi eseguire utilizzando le API di monetizzazione. La tabella elenca anche dove puoi trovare istruzioni dettagliate sull'esecuzione di queste attività.
Attività | Dove trovare le istruzioni |
---|---|
Visualizza i Termini e condizioni accettati da uno sviluppatore |
Visualizzare i Termini e condizioni accettati da uno sviluppatore o da una società tramite l'API |
Visualizzare i pacchetti API accettati da uno sviluppatore | |
Creare un piano tariffario per sviluppatori | |
Visualizzare i piani tariffari disponibili per uno sviluppatore | |
Visualizza i piani tariffari disponibili per uno sviluppatore specifico che contengono un prodotto specifico | |
Visualizza solo i piani tariffari per sviluppatori accettati |
Visualizzare tutti i piani tariffari accettati da uno sviluppatore utilizzando l'API |
Assegna il credito a uno sviluppatore | |
Impostare un massimale di credito per uno sviluppatore | |
Visualizzare un massimale di credito dello sviluppatore | |
"Ricaricare" (aggiungere un importo) al saldo prepagato di uno sviluppatore | |
Visualizzare il saldo prepagato di uno sviluppatore |
Visualizzare i saldi prepagati dell'account di uno sviluppatore |
Configurare una condizione di notifica per uno sviluppatore | |
Creare e visualizzare le definizioni dei report per uno sviluppatore |