Stai visualizzando la documentazione di Apigee Edge.
Consulta la
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. Per esporre le API su Edge, devi creare proxy API che fungano da "facade" 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'è un'API?
Un'API è un'interfaccia che consente a un'applicazione di "utilizzare" funzionalità o dati di un'altra applicazione. Definendo punti di ingresso stabili e semplificati per la logica delle applicazioni e i dati, le API consentono agli sviluppatori di accedere e riutilizzare facilmente la logica delle applicazioni creata da altri sviluppatori. Nel caso delle "API web", questa logica e questi 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 a 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 coinvolgere alcun servizio di backend. Puoi creare queste applicazioni in JavaScript, Java, e Node.js.
Che cos'è un proxy API?
Per esporre le API su Apigee Edge, devi implementare 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. Quando apporti modifiche di backend ai tuoi servizi, le app continuano a chiamare la stessa API senza interruzioni.
In una configurazione di 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 anche se le app accedono al proxy API tramite HTTP o HTTPS. In genere, colleghi criteri a ProxyEndpoint per applicare la sicurezza, i controlli 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. Configura 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 di 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 nel grafico seguente:
Come si crea un proxy API?
Un proxy API è costituito da un pacchetto di file di configurazione XML e codice (come JavaScript e Java). Apigee offre diversi modi per creare proxy API, tra cui:
- Utilizzare l'interfaccia utente di gestione di Edge per definire un proxy API in una GUI (Graphical User Interface). 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 importarli in Edge.
- Utilizzare l'API di gestione di Edge per creare i proxy API effettuando una serie di richieste REST a Edge.
- Eseguire 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 criteri. Un criterio è come un modulo che implementa una funzione di gestione specifica e limitata come parte del flusso di richiesta/risposta del proxy. I criteri sono progettati per consentirti di aggiungere in modo semplice e affidabile tipi comuni di funzionalità di gestione a un'API. 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 il Creare il tuo primo proxy API.
Un ottimo modo per scoprire i proxy API è lavorare con gli esempi come descritto in Utilizzare i proxy API di esempio.