Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. info
Apigee Edge ti consente di creare in modo semplice e rapido API RESTful che possono essere utilizzate dagli sviluppatori di app. Esponi le API su Edge 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 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 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 Edge ti consente di creare API e, se ne hai già, di esporle direttamente, aggiungendo 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 Edge.
Edge ti consente anche di creare API implementando applicazioni ospitate sulla piattaforma API Services, senza alcun servizio di backend. Puoi creare queste applicazioni in JavaScript, Java e su Node.js.
Che cos'è un proxy API?
Puoi esporre le API su Apigee Edge 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:
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:
- Utilizzo dell'interfaccia utente di gestione di Edge 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 ad altri file di supporto, che definiscono il proxy API e poi importarli in Edge.
- Utilizza l'API di gestione di Edge per creare i proxy API inviando una serie di richieste REST a Edge.
- Esegui il deployment di un'applicazione Node.js come proxy. Consulta Eseguire il deployment di un'app Node.js autonoma.
Cosa sono le norme?
Edge ti consente di controllare il comportamento delle API senza scrivere codice utilizzando i 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.
Un ottimo modo per conoscere i proxy API è utilizzare gli esempi come descritto in Utilizzare i proxy API di esempio.