Questa pagina si applica a Apigee e Apigee ibridi.
Visualizza documentazione di Apigee Edge.
La pubblicazione è il processo con cui le API sono disponibili agli sviluppatori di app per il consumo eccessivo.
Video: il seguente video offre un'introduzione generale all'API pubblicazione.
La pubblicazione delle API comporta le seguenti attività, descritte in questo argomento:
- Crea i prodotti API che raggruppano le tue API.
- Registra gli sviluppatori di app.
- Registrazione di app sviluppatore.
- Fornisci documentazione e assistenza della community per le tue API.
Attività 1: crea un prodotto API
La prima attività nella pubblicazione è creare un prodotto API. Un prodotto API è una raccolta Risorse API offerte come pacchetto agli sviluppatori di app per il consumo. Crea prodotti API utilizzando l'API o l'interfaccia utente di Apigee. (Consulta Che cos'è un prodotto API? per saperne di più sulle API products.)
In questa figura, l'API è costituita da due prodotti, ciascuno contenente tre risorse API.
In qualità di fornitore di API, sei responsabile della creazione delle API e dei prodotti API per gestire il controllo dell'accesso, le limitazioni di utilizzo e qualsiasi altro requisito aziendale. Ad esempio, potrebbe:
- Rilascia un prodotto API gratuito che consente l'accesso di sola lettura alle relative risorse API.
- L'azienda può rilasciare un secondo prodotto API a un prezzo ridotto che consenta l'accesso in lettura/scrittura alle stesse risorse API della versione gratuita, ma con un limite di accesso ridotto, ad esempio 1000 richieste al giorno.
- Rilascia un terzo prodotto API a un prezzo superiore che permetta l'accesso in lettura/scrittura allo stesso risorsa API, ma con un limite di accesso elevato.
La cosa importante da ricordare è che Apigee vi offre la flessibilità per creare prodotti API che soddisfano i requisiti aziendali delle tue API.
Per ulteriori informazioni sulla creazione di prodotti API, consulta Gestione dei prodotti API.
Attività 2: registra uno sviluppatore di app
Uno sviluppatore crea le app che utilizzano le tue API. Uno sviluppatore di app si registra su Apigee prima di poter registrare la propria app. Quando registra la propria app, riceve una chiave API che consentirà all'app di accedere all'API.
Tramite la procedura di registrazione dell'app, puoi controllare chi può accedere alle tue API. In qualsiasi momento, puoi eliminare uno sviluppatore di app, annullando così tutte le chiavi API associate a quello sviluppatore, negando quindi l'accesso alle tue API da parte dello sviluppatore.
In qualità di fornitore di API, sei tu a decidere come registrare gli sviluppatori. Ad esempio, puoi utilizzare una procedura di registrazione che richiede che un potenziale sviluppatore contatti la tua organizzazione per registro. Il potenziale sviluppatore deve fornire tutte le informazioni necessarie, ad esempio un'email indirizzo, nome e cognome. Se approvi la richiesta dello sviluppatore, può utilizzare la UI di Apigee per registrare manualmente lo sviluppatore. Per scoprire di più, consulta la sezione Registrazione degli sviluppatori di app.
Attività 3: registra un'app sviluppatore
Prima di poter accedere alle API, un'app deve essere registrata. Tuttavia, solo un sviluppatore registrato può registrare un'app.
Al momento della registrazione dell'app, lo sviluppatore seleziona uno o più prodotti basati su API. Ad esempio: potresti pubblicare più prodotti API corrispondenti a diversi tipi di servizi e prezzi piani. Lo sviluppatore dell'app può quindi scegliere dall'elenco di prodotti API disponibili.
In risposta alla registrazione dell'app su Apigee, Apigee assegna all'app una chiave API univoca. L'app deve passare questa chiave API in ogni richiesta a una risorsa API. La chiave viene autenticata e, se valida, la richiesta viene concessa. In qualsiasi momento, in qualità di fornitore di servizi, puoi revocare la chiave in modo che l'app non possa più accedere alle tue API.
In qualità di provider API, puoi decidere in che modo registrare le app. Potresti:
- Utilizza una procedura manuale che richiede a uno sviluppatore di contattare la tua organizzazione per registrare la propria app. In risposta, dovresti inviare allo sviluppatore la chiave API, possibilmente email.
- Utilizza l'API Apigee per integrare la funzionalità di registrazione delle app e il caricamento delle chiavi nel tuo sito web.
- Per un account Apigee a pagamento, utilizza il portale Apigee Developer Services, che offre il supporto integrato per la registrazione delle app e l'invio delle chiavi API.
Per ulteriori informazioni, consulta Registrare le app e gestire le chiavi API.
Attività 4: documenta le tue API
Una considerazione importante per la pubblicazione di prodotti API è la documentazione e un meccanismo di feedback degli sviluppatori. I portali per sviluppatori con funzioni di pubblicazione social sono sempre più per le comunicazioni con la comunità di sviluppatori. Ciò include comunicazioni statiche contenuti, come la documentazione dell'API e i Termini e condizioni d'uso, nonché contenuti dinamici come blog e forum, nonché funzioni di assistenza clienti.
Puoi creare il tuo sito web per implementare la documentazione o, se hai un account Apigee pagato, puoi utilizzare il portale Apigee Developer Services. Il portale ha supporto integrato per la documentazione, i blog, i forum e gli altri tipi di contenuti necessari per il supporto la tua community di sviluppatori.
SmartDocs ti consente di documentare le tue API sul portale Servizi per sviluppatori in un che rende la documentazione dell'API completamente interattiva. Documentazione interattiva con SmartDocs significa che gli utenti del portale possono:
- Informazioni sull'API
- Invia una richiesta in tempo reale all'API
- Visualizzare una risposta in tempo reale restituita dall'API
Per saperne di più, consulta le seguenti sezioni:
- Portale integrato: Pubblicazione delle API
- Drupal 10: Documenta le tue API