Informazioni sulle API e sui proxy API

Questa pagina si applica a Apigee e Apigee ibrido.

Visualizza la documentazione di Apigee Edge.

Apigee 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 per i servizi 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 dati da un'altra applicazione. Mediante la definizione di punti di ingresso stabili e semplificati per la logica e i dati dell'applicazione, le API consentono agli sviluppatori di accedere facilmente alla logica dell'applicazione creata da altri sviluppatori e riutilizzarla. 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 un certo livello di garanzia che, nel tempo, l'API cambierà in modo prevedibile.

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

Apigee ti consente inoltre di creare API implementando applicazioni ospitate sulla piattaforma Servizi API, senza alcun 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. Man mano che apporti modifiche al backend ai 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. Configura il ProxyEndpoint per definire l'URL del proxy API. Inoltre, l'endpoint proxy determina se le app accedono al proxy API tramite HTTP o HTTPS. In genere, colleghi criteri al ProxyEndpoint per applicare sicurezza, controlli delle quote e altri tipi di controllo dell'accesso e limitazione di frequenza.
  • TargetEndpoint: definisce il modo in cui il proxy API interagisce con i servizi di backend. Configura TargetEndpoint in modo che inoltri le richieste al servizio di backend appropriato, definendo eventuali impostazioni di sicurezza, il protocollo HTTP o HTTPS e altre informazioni di connessione. Puoi collegare criteri a TargetEndpoint per assicurarti che i messaggi di risposta 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 entrano attraverso l'endpoint della richiesta proxy, vengono passate all'endpoint della richiesta di destinazione e quindi inviate ai servizi di backend. Le risposte HTTP vengono inserite tramite l'endpoint di risposta di destinazione, vengono passate 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 nei prodotti API.
  • I proxy estensibili includono almeno un criterio estensibile o un 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 e codice di configurazione XML (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 un proxy API semplice.
  • Creare file XML, insieme a qualsiasi altro file di supporto, che definisce il tuo proxy API e quindi importarli in Apigee.
  • Utilizzo dell'API Apigee per creare proxy API effettuando una serie di richieste REST 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 della configurazione del proxy API durante l'iterazione. Le revisioni sono numerate in sequenza per consentirti di annullare 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 mentre continui a creare nuove revisioni di tale proxy API in un ambiente di test. Quando è tutto pronto, puoi promuovere la revisione superiore del proxy API 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 i criteri. Un criterio è come un modulo che implementa una funzione di gestione specifica e limitata nell'ambito del flusso di richiesta/risposta proxy. I criteri sono progettati per consentirti di aggiungere i tipi comuni di funzionalità di gestione a un'API in modo semplice e affidabile. I criteri offrono funzionalità come sicurezza, limitazione di frequenza, trasformazione e mediazione, consentendoti di non dover programmare e 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 la sezione Creare il primo proxy API. Consulta anche altri argomenti introduttivi.

Scopri di più