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 facilmente e rapidamente API RESTful che possono essere utilizzate dagli sviluppatori di app. Esporre le API su Apigee creando proxy API che fungono da "facade" gestite per i servizi di backend. Questo argomento descrive 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 funzionalità o dati di un'altra applicazione. Definendo punti di accesso stabili e semplificati alla logica e ai dati delle applicazioni, le API consentono agli sviluppatori di accedere e riutilizzare facilmente la logica delle applicazioni 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 fornisce 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 un livello di gestione e visibilità. Se hai servizi abilitati HTTP, ad esempio 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 coinvolgere alcun servizio di backend. Puoi creare queste applicazioni in JavaScript e Java.

Che cos'è un proxy API?

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 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 proxy determina anche se le app accedono al proxy API tramite HTTP o HTTPS. In genere colleghi policy a ProxyEndpoint per applicare sicurezza, controlli delle quote e altri tipi di controllo dell'accessoso e limitazione della frequenza.
  • TargetEndpoint: definisce il modo in cui il proxy API interagisce con i tuoi servizi di backend. Configuri TargetEndpoint per inoltrare le richieste al servizio di backend corretto, inclusi la definizione di eventuali impostazioni di sicurezza, il protocollo HTTP o HTTPS e altre informazioni di connessione. Puoi collegare policy 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 tramite l'endpoint di richiesta proxy, vengono trasmesse all'endpoint di richiesta di destinazione e poi inviate ai servizi di backend. Le risposte HTTP entrano tramite l'endpoint di risposta di destinazione, vengono trasmesse 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 hook di policy estensibile o 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 codice (come JavaScript e Java). Apigee offre diversi modi per creare proxy API, tra cui:

  • Utilizzo della UI di Apigee per definire un proxy API in una Graphic User Interface (GUI). Per saperne di più, consulta Crea un proxy API semplice.
  • Creazione di file XML, insieme a tutti gli altri file di supporto, che definiscono il proxy API e la loro importazione in Apigee.
  • Utilizzando l'API Apigee per creare i proxy API effettuando una serie di richieste REST ad Apigee.
  • Sviluppa localmente 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 alla configurazione del proxy API durante l'iterazione. Le revisioni sono numerate in sequenza, il che ti consente di annullare una modifica eseguendo il deployment di 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 dello stesso proxy API in un ambiente di test. Quando è tutto pronto, puoi promuovere la revisione più recente del proxy API dall'ambiente di test a quello di 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 specifica e limitata come parte del flusso di richiesta/risposta del proxy. Le norme sono progettate per consentirti di aggiungere tipi comuni di funzionalità di gestione a un'API in modo semplice e affidabile. I criteri forniscono funzionalità come sicurezza, limitazione di frequenza, trasformazione e mediazione, evitando di dover codificare e 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 Crea il tuo primo proxy API. Consulta anche altri argomenti della Guida introduttiva.

Scopri di più