Informazioni sulle API e sui proxy API

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X.
informazioni

Apigee Edge consente di creare in modo facile e veloce API RESTful che possono essere utilizzate dagli sviluppatori di app. Puoi esporre le API su Edge creando proxy API che fungono da "facce" gestite per i servizi di backend. Questo argomento illustra la relazione tra API e proxy API su Apigee Edge.

Video: guarda questo breve video per un'introduzione ai proxy API.

Che cos'è una API?

Un'API è un'interfaccia che consente a un'applicazione di "utilizzare" facilmente funzionalità o dati di un'altra applicazione. Mediante la definizione di entry point stabili e semplificati per la logica e i dati dell'applicazione, le API consentono agli sviluppatori di accedere facilmente alla logica dell'applicazione e di riutilizzarla 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 una certa garanzia che, nel tempo, l'API cambierà in modo prevedibile.

Apigee Edge ti consente di creare API e, se ne hai già delle API, esporle 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 Edge.

Edge consente inoltre di creare API implementando applicazioni ospitate sulla piattaforma Servizi API, senza alcun servizio di backend. Puoi creare queste applicazioni in JavaScript, Java e in Node.js.

Che cos'è un proxy API?

Puoi esporre le API su Apigee Edge 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 alcuna interruzione.

In una configurazione proxy API esistono due tipi di endpoint:

  • ProxyEndpoint: definisce il modo in cui le app client utilizzano le tue API. Devi configurare ProxyEndpoint per definire l'URL del proxy API. L'endpoint proxy determina inoltre se le app accedono al proxy API tramite HTTP o HTTPS. In genere, i criteri vengono collegati a ProxyEndpoint per applicare la sicurezza, i controlli delle quote e altri tipi di controllo dell'accesso e limitazione della frequenza.
  • TargetEndpoint: definisce il modo in cui il proxy API interagisce con i servizi di backend. Devi configurare TargetEndpoint per inoltrare le richieste al servizio di backend appropriato, inclusa la definizione di eventuali impostazioni di sicurezza, protocollo HTTP o HTTPS e altre informazioni sulla 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 dall'immagine di seguito:

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

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 di gestione perimetrale per definire un proxy API in una Graphical User Interface (GUI). Per saperne di più, consulta Creare un proxy API semplice.
  • Creare file XML, insieme a eventuali altri file di supporto, che definiscono il proxy API e quindi importarli in Edge.
  • Utilizzo dell'API di gestione perimetrale per creare i proxy API mediante l'esecuzione di una serie di richieste REST a Edge.
  • Eseguire il deployment di un'applicazione Node.js come proxy. Vedi Deployment di un'app Node.js autonoma.

Cosa sono le norme?

Edge consente di controllare il comportamento dell'API senza scrivere 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 tipi comuni di funzionalità di gestione a un'API in modo facile e affidabile. I criteri offrono funzionalità come sicurezza, limitazione della frequenza, trasformazione e mediazione, evitandoti di dover programmare e gestire questa funzionalità in autonomia.

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.

Un ottimo modo per conoscere i proxy API è utilizzare gli esempi come descritto in Utilizzo dei proxy API di esempio.

Scopri di più