Informazioni sulle API e sui proxy API

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Apigee ti consente di creare in modo semplice e rapido API RESTful che possono essere utilizzate dagli sviluppatori di app. Puoi esporre le API su Apigee creando proxy API che fungono da "facades" gestiti 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 le funzionalità o i dati di un'altra applicazione. Definendo punti di contatto stabili e semplificati per la logica e i 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 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 abilitati per HTTP, come i servizi web basati su SOA, possono essere esposti anche come API tramite Apigee.

Apigee ti consente anche di creare API implementando applicazioni ospitate sulla piattaforma API Services, 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 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 del proxy API esistono due tipi di endpoint:

  • ProxyEndpoint:definisce il modo in cui le app client utilizzano le tue API. Configura ProxyEndpoint per definire l'URL del proxy API. L'endpoint del proxy determina inoltre se le app accedono al proxy API tramite HTTP o HTTPS. In genere, colleghi policies a ProxyEndpoint per applicare la sicurezza, i controlli delle quote e altri tipi di controllo dell'accesso e di limitazione della frequenza.
  • TargetEndpoint: definisce il modo in cui il proxy API interagisce con i tuoi servizi di backend. Configura TargetEndpoint per inoltrare le richieste al servizio di backend corretto, inclusa la definizione di eventuali impostazioni di sicurezza, del protocollo HTTP o HTTPS e di altre informazioni di connessione. Puoi allegare policies 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 nella figura seguente:

Le richieste HTTP entrano tramite l'endpoint della richiesta proxy, vengono passate all'endpoint della richiesta di destinazione e poi inviate ai servizi di backend. Le risposte HTTP entrano tramite l'endpoint di risposta di destinazione, vengono comunicate all'endpoint di risposta del proxy e poi di nuovo al client.

Tipi di proxy API

Apigee supporta due tipi di proxy:

  • I proxy standard includono solo norme standard. I proxy standard sono adatti a soluzioni API leggere e non possono essere inclusi nei prodotti API.
  • I proxy estensibili includono almeno un criterio estensibile o un hook del 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:

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 ti consentono di eseguire il deployment di un proxy API in un ambiente di produzione continuando a creare nuove revisioni del proxy API in un ambiente di test. Quando è tutto pronto, puoi promuovere la revisione più recente del proxy API dalla versione di test a quella di produzione.

Che cos'è una norma?

Apigee ti consente di controllare il comportamento delle API senza scrivere codice utilizzando policies. Un criterio è simile a un modulo che implementa una funzione di gestione specifica e limitata nell'ambito del flusso di richiesta/risposta del proxy. I criteri sono progettati per consentirti di aggiungere tipi comuni di funzionalità di gestione a un'API in modo facile e affidabile. I criteri forniscono funzionalità come sicurezza, limitazione di frequenza, trasformazione e mediazione, per consentirti di non dover codificare e manutenere questa funzionalità autonomamente.

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 gli altri argomenti della Guida introduttiva.

Scopri di più