Informazioni sulle API e sui proxy API

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Apigee consente di creare in modo semplice e veloce API RESTful che possono essere utilizzate dagli sviluppatori di app. Puoi esporre 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 consumare facilmente funzionalità o dati di un'altra applicazione. Definindo entry point stabili e semplificati alla logica e ai dati dell'applicazione, le API consentono agli sviluppatori di accedere e riutilizzare facilmente la logica dell'applicazione creata da altri sviluppatori. Nel caso delle API web, la logica e i dati vengono 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 ne hai già di una, di esporle direttamente, aggiungendo al contempo un livello di gestione e visibilità. Se hai servizi abilitati per HTTP, ad esempio 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 API Services, senza bisogno di alcun servizio di backend. Puoi creare queste applicazioni in JavaScript e Java.

Che cos'è un proxy API?

Esponi le API su Apigee implementando i proxy API. I proxy API disaccoppiano l'API rivolta alle app dai servizi di backend, proteggendo queste app dalle modifiche al codice di backend. Man mano che apporti modifiche al backend dei tuoi servizi, le app continuano a chiamare la stessa API senza interruzioni.

In una configurazione del proxy API esistono due tipi di endpoint:

  • ProxyEndpoint: definisce il modo in cui le app client utilizzano le API. Devi configurare ProxyEndpoint in modo da definire l'URL del proxy API. L'endpoint proxy determina inoltre se le app accedono al proxy API tramite HTTP o HTTPS. In genere, devi collegare criteri a ProxyEndpoint per applicare controlli della sicurezza, 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. Puoi configurare TargetEndpoint per inoltrare le richieste al servizio di backend appropriato, definendo eventuali impostazioni di sicurezza, il protocollo HTTP o HTTPS e altre informazioni sulla connessione. Puoi allegare 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 seguente:

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 entrano attraverso l'endpoint di risposta target, vengono passate all'endpoint di risposta proxy e poi di nuovo al client.

Tipi di proxy API

Apigee supporta due tipi di proxy:

  • I proxy standard includono solo i 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 codice e file di configurazione XML (come JavaScript e Java). Apigee offre diversi modi per creare proxy API, tra cui:

  • Utilizzo dell'interfaccia utente Apigee per definire un proxy API in un'interfaccia utente grafica (GUI). Per saperne di più, consulta Creare un proxy API semplice.
  • Creazione di file XML, insieme a eventuali altri file di supporto, che definiscono il proxy API e quindi li importi in Apigee.
  • Utilizzo dell'API Apigee per creare proxy API effettuando una serie di richieste REST ad Apigee.
  • Sviluppa localmente utilizzando Apigee in VS Code ed esegui il deployment come archivio. Per maggiori informazioni, consulta la pagina Panoramica dello sviluppo locale con Apigee

Che cos'è una revisione del proxy API?

Le revisioni dei proxy API offrono un meccanismo leggero per gestire gli aggiornamenti della configurazione del proxy API durante l'iterazione. Le revisioni sono numerate in sequenza, consentendoti di 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 mentre continui a creare nuove revisioni di quel proxy API in un ambiente di test. Quando è tutto pronto, puoi promuovere la revisione superiore del proxy API dal test alla produzione.

Che cosa sono le norme?

Apigee ti consente di controllare il comportamento delle API senza scrivere codice utilizzando i criteri. Un criterio è come un modulo che implementa una funzione di gestione limitata e specifica nell'ambito del flusso di richiesta/risposta proxy. I criteri sono progettati per consentirti di aggiungere 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, in modo da non dover programmare e gestire in autonomia 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 pagina Crea il tuo primo proxy API. Vedi anche altri argomenti per iniziare.

Scopri di più