Terminologia di base

Un'interfaccia di programmazione di un'applicazione, ovvero un'interfaccia che consente a un' applicazione di utilizzare facilmente funzionalità o dati di un'altra applicazione.

Definendo punti di accesso stabili e semplificati alla logica e ai dati delle applicazioni, le API consentono gli sviluppatori di accedere e riutilizzare facilmente la logica delle applicazioni creata da altri sviluppatori. Nel caso delle API web, questa logica e questi dati vengono esposti sulla rete. Poiché le applicazioni che utilizzano le API sono sensibili alle modifiche, le API implicano anche un contratto. Il contratto fornisce un certo livello di garanzia che, nel tempo, l'API cambierà in modo prevedibile manner.

Apigee fornisce una vasta gamma di informazioni sulle API e sulle best practice per svilupparle e utilizzarle. Per iniziare, guarda il webcast API Design o scarica l'eBook senza costi Web API Design: The Missing Link Best Practices for Crafting Interfaces that Developers Love.

Un'interfaccia su Edge per una o più API, servizi HTTP generici o applicazioni (ad esempio Node.js).

Un proxy API viene implementato come un insieme di file di configurazione, criteri e codice che si basano su un insieme di risorse fornite da Apigee Edge. I proxy API possono essere generati e configurati utilizzando l'interfaccia utente di gestione di Apigee Edge oppure possono essere implementati localmente in un editor di testo o in un IDE.

L'interfaccia fornita da un proxy API disaccoppia l'API per gli sviluppatori dai servizi di backend proteggendo gli sviluppatori dalle modifiche al codice e consentendo l'innovazione all'edge senza influire sui team di sviluppo interni. Quando i team di sviluppo apportano modifiche al backend gli sviluppatori continuano a chiamare la stessa interfaccia senza interruzioni. Apigee ti consente di esporre più interfacce alla stessa API, consentendoti di personalizzare la firma di un'API per soddisfare contemporaneamente le esigenze di varie nicchie di sviluppatori.

API definite da indirizzi di rete e URI. Un'API è costituita da un percorso di base e da un insieme di risorse API. Ogni proxy API definisce un percorso di base e, facoltativamente, multiple percorsi di risorse API. Puoi considerare un'API semplicemente come un insieme di URI, tutti con un percorso di base comune.

Per semplificare la gestione delle API, Apigee aumenta questi URI non elaborati con nomi visualizzati e descrizioni. Edge ti consente di collegare criteri e codice agli URI, consentendo un controllo e una gestione granulari del comportamento delle tue API.

Una raccolta di risorse API (URI) combinata con una quota o un piano di servizi, che è pubblicata per gli sviluppatori di app in fase di progettazione. I prodotti API possono a loro volta essere raggruppati in API packages per la monetizzazione.

Una chiave API è associata a uno o più prodotti API, applicando un'associazione tra un'app e il pacchetto di URI che l'app è autorizzata a utilizzare.

Un'abbreviazione di applicazione. Il termine app è diventato un riferimento alle applicazioni mobile che utilizzano le API. Gli sviluppatori implementano le app in una varietà di linguaggi di programmazione e utilizzando varie tecnologie e piattaforme. Gli sviluppatori che vogliono utilizzare API registrano le app nell'organizzazione di un provider di API su Apigee Edge.

Quando l'app viene registrata, Apigee genera una chiave API e un secret che identificano l' app. Lo sviluppatore incorpora la chiave API nell'app, che la presenta quando effettua le richieste. I servizi API implementano la sicurezza intorno alla chiave API tramite la convalida diretta della chiave API o tramite OAuth.

Un contesto di esecuzione di runtime per i proxy API. Un proxy API deve essere sottoposto a deployment in un ambiente prima che l'API che espone sia accessibile tramite la rete. Per impostazione predefinita, le organizzazioni vengono sottoposte a provisioning con due ambienti: test e prod.

• L'ambiente test viene in genere utilizzato per il deployment dei proxy API durante lo sviluppo.
• L'ambiente prod viene in genere utilizzato per promuovere i proxy API dall'ambiente di test dopo che sono stati completamente sviluppati e testati.

Un container per tutti gli oggetti in un account Apigee Edge, inclusi proxy API, prodotti API pacchetti API, app e sviluppatori.

Per ogni organizzazione di cui fai parte è necessario un account utente. (La maggior parte degli utenti avrà un account in una sola organizzazione.)

Un passaggio di elaborazione che viene eseguito come unità di logica atomica e riutilizzabile all'interno di un flusso di elaborazione del proxy API.

Le funzionalità tipiche basate su norme includono la trasformazione dei formati dei messaggi, l'applicazione del controllo dell'accesso la chiamata di servizi remoti per informazioni aggiuntive, la mascheratura dei dati sensibili per gli utenti esterni, l'esame dei contenuti dei messaggi per potenziali minacce, la memorizzazione nella cache delle risposte comuni per migliorare le prestazioni e così via.

Le norme possono essere eseguite in modo condizionale in base al contenuto o al contesto di un messaggio di richiesta o risposta. Ad esempio, è possibile eseguire una norma di trasformazione per personalizzare un formato di risposta se il messaggio di richiesta è stato inviato da uno smartphone.

La versione dell'interfaccia API per gli sviluppatori.

Ad esempio, pivotaltracker.com/services/v3 o api.enterprise.apigee.com/v1.

Questo termine si distingue da revisione, ovvero il pacchetto numerato e con controllo della versione di configurazione e norme raggruppate in un proxy API. Le interfacce API hanno versioni, mentre i proxy API hanno revisioni.