Informazioni sulle API e sui proxy API

Questa pagina si applica a Apigee e Apigee ibridi.

Visualizza documentazione di Apigee Edge.

Apigee consente di creare in modo semplice e rapido API RESTful utilizzabili per app sviluppatori. Esponi le API su Apigee creando proxy API che fungono da "facade" gestite della di backend. Questo argomento illustra la relazione tra API e proxy API su Apigee.

Video: guarda questo breve video per un'introduzione alle API proxy.

Che cos'è un'API?

Un'API è un'interfaccia che consente a un'applicazione di utilizzare facilmente funzionalità o i dati di un'altra applicazione. definendo punti di ingresso stabili e semplificati alla logica dell'applicazione e dati, le API consentono agli sviluppatori di accedere facilmente alla logica dell'applicazione e riutilizzarla sviluppatori. Nel caso delle API web, la logica e i dati sono esposti sulla rete.

Poiché le applicazioni che utilizzano API sono sensibili alle modifiche, le API implicano anche un contratto. Il contratto fornisce una certa garanzia che, nel tempo, l'API cambierà in modo prevedibile.

Apigee ti consente di creare API e, se le hai già, esporle direttamente, aggiungendo al contempo un livello di gestione e visibilità. Se hai servizi abilitati per HTTP, come I servizi web basati su SOA possono anche essere esposti come API tramite Apigee.

Apigee ti consente inoltre di creare API implementando applicazioni ospitate sui servizi API senza bisogno di servizio di backend. Puoi creare queste applicazioni in JavaScript Java.

Che cos'è un proxy API?

Puoi esporre le API su Apigee implementando i proxy API. I proxy API disaccoppiano API per le app dai tuoi servizi di backend, proteggendole dal codice backend. modifiche. Man mano che apporti modifiche al backend dei tuoi servizi, le app continuano a chiamare la stessa API senza alcuna interruzione.

In una configurazione proxy API esistono due tipi di endpoint:

  • ProxyEndpoint: definisce il modo in cui le app client utilizzano le API. Tu configurare il ProxyEndpoint per definire l'URL del proxy API. L'endpoint proxy inoltre determina se le app accedono al proxy API tramite HTTP o HTTPS. Di solito ti alleghi criteri al ProxyEndpoint per applicare sicurezza, controlli delle quote e altri tipi di controllo dell'accesso e della limitazione di frequenza.
  • TargetEndpoint: definisce il modo in cui il proxy API interagisce con di backend. Configura TargetEndpoint in modo che inoltri le richieste al backend appropriato servizio, inclusa la definizione di impostazioni di sicurezza, il protocollo HTTP o HTTPS e altre impostazioni informazioni. Puoi collegare criteri a TargetEndpoint per garantire che la risposta i messaggi siano formattati correttamente per l'app che ha effettuato la richiesta iniziale.

Puoi visualizzare i proxy API come mostrato nell'immagine di seguito:

Le richieste HTTP che entrano attraverso l'endpoint della richiesta proxy vengono passate all'endpoint delle richieste di destinazione e quindi inviato ai servizi di backend. Le risposte HTTP inserite tramite l'endpoint di risposta di destinazione vengono passati all'endpoint di risposta del proxy e quindi di nuovo al client.

Tipi di proxy API

Apigee supporta due tipi di proxy:

  • I proxy standard includono solo criteri standard. I proxy standard sono adatti per soluzioni API leggere e non possono essere inclusi in prodotti API.
  • I proxy estensibili ne includono almeno uno criterio estensibile o hook di flusso. I proxy estensibili possono includere molte più funzionalità rispetto ai proxy standard.

Come si crea un proxy API?

Un proxy API è costituito da un bundle di file di configurazione XML e di codice (come JavaScript e Java). Apigee offre diversi modi per creare proxy API, tra cui:

  • Utilizzo dell'UI di Apigee per definire un proxy API in una Graphical User Interface (GUI). Per ulteriori informazioni, consulta Creare una proxy API.
  • Creazione di file XML, insieme a qualsiasi altro file di supporto, che definisce il proxy API e e poi importarle in Apigee.
  • Utilizzo dell'API Apigee per creare proxy API mediante l'esecuzione di una serie di di archiviazione ad Apigee.
  • Sviluppa in locale utilizzando Apigee in VS Code ed esegui il deployment come archivio. Per ulteriori informazioni, consulta Panoramica dello sviluppo locale con Apigee

Che cos'è una revisione del proxy API?

Le revisioni del proxy API forniscono un meccanismo leggero per gestire gli aggiornamenti del proxy API la configurazione man mano che esegui l'iterazione. Le revisioni sono numerate in sequenza, in modo da poter ripristinare una modifica eseguendo il deployment di una revisione precedente del proxy API. Le revisioni consentono di eseguire il deployment di un proxy API in un ambiente di produzione continuando a creare nuove revisioni del proxy API in un nell'ambiente di test. Quando è tutto pronto, puoi promuovere la revisione superiore dell'API proxy dalla fase di test alla produzione.

Che cosa sono le norme?

Apigee ti consente di controllare il comportamento delle API senza scrivere alcun codice utilizzando norme. Un criterio è come un modulo che implementa una funzione di gestione specifica e limitata nell'ambito di un flusso di richiesta/risposta proxy. I criteri sono progettati per consentirti di aggiungere tipi comuni di gestione le funzionalità a un'API in modo semplice e affidabile. I criteri offrono funzionalità come sicurezza, di limitazione della frequenza di traffico, trasformazione e mediazione, consentendoti di non dover scrivere codice gestire autonomamente questa funzionalità.

Crea il tuo primo proxy API

Apigee offre una serie di tutorial che puoi utilizzare per creare la tua prima API. Inizia con Crea il tuo primo proxy API. Consulta anche altri argomenti introduttivi.

Scopri di più