Informazioni sulle API e sui proxy API

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza documentazione di Apigee Edge.

Apigee ti consente di creare in modo semplice e rapido API RESTful che possono essere utilizzate dagli sviluppatori di app. 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 ai proxy API.

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 le API sono sensibili alle modifiche, le API implicano anche un contratto. Il contratto offre un certo livello di garanzia che, nel tempo, l'API cambierà in modo prevedibile.

Apigee ti consente di creare API e, se ne hai già, di esporle direttamente, aggiungendo al contempo un livello di gestione e visibilità. Se hai servizi HTTP abilitati, 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 e Java.

Che cos'è un proxy API?

Puoi esporre le API su Apigee implementando i proxy API. I proxy API disaccoppiano l'API per le app dai tuoi servizi di backend, proteggendo le app dalle modifiche al codice del backend. Quando apporti modifiche al backend dei tuoi servizi, le app continuano a chiamare la stessa API senza interruzioni.

In una configurazione proxy API esistono due tipi di endpoint:

  • ProxyEndpoint: definisce il modo in cui le app client utilizzano le tue 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 i tuoi servizi 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 vengono inserite tramite 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 basati su 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 insieme di file di configurazione XML e codice (ad esempio 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 saperne di più, consulta Creare un proxy API semplice.
  • Crea file XML, insieme ad altri file di supporto, che definiscono il proxy API e poi importarli 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 la 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 della configurazione del proxy API durante l'iterazione. Le revisioni sono numerate in sequenza, il che ti consente di annullare una modifica implementando 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 cos'è una norma?

Apigee ti consente di controllare il comportamento delle API senza scrivere codice utilizzando criteri. 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 fornisce una serie di tutorial che puoi utilizzare per creare la tua prima API. Inizia con la sezione Crea il tuo primo proxy API. Consulta anche altri argomenti introduttivi.

Scopri di più