Stai visualizzando la documentazione di Apigee Edge.
Consulta la
documentazione di Apigee X. info
Apigee Edge è una piattaforma per lo sviluppo e la gestione di API. Utilizzando un livello proxy per i servizi, Edge fornisce un'astrazione o una facade per le API dei servizi di backend e offre sicurezza, limitazione della frequenza, quote, analisi e altro ancora.
Ad esempio, puoi guardare un webcast su come Walgreens utilizza le API e Apigee Edge per fornire un ricco ecosistema di app per la stampa di foto, le prescrizioni e altri servizi che offre.
Accelerazione digitale
Questo video offre una rapida panoramica di come Apigee ti aiuta a evolvere la tua attività in un'attività digitale.
Scegliere tra la gestione dei servizi e la gestione delle API
Questo video ti aiuta a comprendere le importanti differenze tra la gestione dei servizi e la gestione delle API. attività.
Rendere disponibili i servizi sul web
Oggi le aziende vogliono rendere disponibili i propri servizi di backend sul web in modo che questi servizi possano essere utilizzati dalle app in esecuzione su dispositivi mobili e computer. Un'azienda potrebbe voler esporre servizi che forniscono informazioni sui prezzi e sulla disponibilità dei prodotti, servizi di vendita e ordinazione servizi, servizi di monitoraggio degli ordini e qualsiasi altro servizio richiesto dalle app client.
Le aziende spesso espongono i servizi come un insieme di endpoint HTTP. Gli sviluppatori di app client inviano quindi richieste HTTP a questi endpoint. A seconda dell'endpoint, il servizio potrebbe quindi restituire i dati, formattati come XML o JSON, all'app client.
Le app client che utilizzano questi servizi possono essere implementate come app autonome per un dispositivo mobile o tablet, come app HTML5 in esecuzione in un browser o come qualsiasi altro tipo di app in grado di inviare una richiesta a un endpoint HTTP e utilizzare i dati di risposta. Queste app potrebbero essere sviluppate e rilasciate dalla stessa azienda che ha esposto i servizi o da sviluppatori di app di terze parti che utilizzano servizi disponibili pubblicamente.
La seguente immagine mostra questo tipo di modello:
Poiché i provider rendono disponibili i propri servizi sul web, devono assicurarsi di aver adottato tutte le misure necessarie per proteggerli dall'accesso non autorizzato. In qualità di fornitore di servizi, valuta:
- Sicurezza: come controllerai l'accesso ai tuoi servizi per impedire l'accesso non autorizzato?
- Compatibilità: i tuoi servizi funzioneranno su piattaforme e dispositivi diversi?
- Misurabilità: come puoi monitorare i tuoi servizi per assicurarti che siano disponibili?
- Monetizzazione: come puoi monitorare e fatturare ai clienti l'accesso ai tuoi servizi?
- E molte altre considerazioni
Dopo il rilascio di un'app client che accede a qualsiasi servizio, il fornitore di servizi è quindi tenuto ad assicurarsi che questi servizi continuino a funzionare nel tempo man mano che li aggiunge, modifica o elimina. Il fornitore di servizi deve anche avere un modo per informare gli sviluppatori di app di eventuali modifiche ai servizi per garantire che le app client rimangano sincronizzate con questi servizi.
Gli sviluppatori di app client incontrano difficoltà quando tentano di utilizzare i servizi di diversi provider. Oggi i fornitori di servizi hanno a disposizione molte tecnologie per esporre i propri servizi. La stessa app client potrebbe dover utilizzare un meccanismo per utilizzare un servizio di un provider e un meccanismo diverso per utilizzare un servizio di un altro provider. Gli sviluppatori di app possono persino trovarsi nella situazione in cui devono utilizzare meccanismi diversi per utilizzare i servizi dello stesso provider.
Rendere disponibili i servizi tramite Apigee Edge
Apigee Edge ti consente di fornire un accesso sicuro ai tuoi servizi con un'API ben definita e coerente in tutti i tuoi servizi, indipendentemente dall'implementazione del servizio. Un'API coerente:
- Semplifica l'utilizzo dei tuoi servizi da parte degli sviluppatori di app.
- Ti consente di modificare l'implementazione del servizio di backend senza influire sull'API pubblica API.
- Ti consente di sfruttare le funzionalità di analisi, monetizzazione, portale per sviluppatori e altre funzionalità integrate in Edge.
La seguente immagine mostra un'architettura con Edge che gestisce le richieste delle app client ai servizi di backend:
Anziché utilizzare direttamente i tuoi servizi, gli sviluppatori di app accedono a un proxy API creato su Edge. Il proxy API funziona come un mapping di un endpoint HTTP disponibile pubblicamente a il tuo servizio di backend. Creando un proxy API, consenti a Edge di gestire le attività di sicurezza e autorizzazione necessarie per proteggere i tuoi servizi, nonché per analizzarli, monitorarli e monetizzarli.
Poiché gli sviluppatori di app inviano richieste HTTP a un proxy API, anziché direttamente ai tuoi servizi, non devono sapere nulla dell'implementazione dei tuoi servizi. Tutto ciò che lo sviluppatore deve sapere è:
- L'URL dell'endpoint del proxy API.
- Eventuali parametri di ricerca, intestazioni o parametri del corpo passati in una richiesta.
- Eventuali credenziali di autenticazione e autorizzazione richieste.
- Il formato della risposta, incluso il formato dei dati di risposta, ad esempio XML o JSON.
Il proxy API isola lo sviluppatore di app dal tuo servizio di backend. Pertanto, puoi modificare l'implementazione del servizio purché l'API pubblica rimanga coerente. Mantenendo un'API frontend coerente, le app client esistenti continueranno a funzionare indipendentemente dalle modifiche apportate al backend.
Puoi utilizzare le policy sul proxy API per aggiungere funzionalità a un servizio senza dover apportare modifiche al servizio di backend. Ad esempio, puoi aggiungere policy al proxy per eseguire trasformazioni e filtri dei dati, aggiungere sicurezza, eseguire logica condizionale o codice personalizzato e eseguire molte altre azioni. La cosa importante da ricordare è che le policy vengono implementate su Edge, non sul server di backend.
Per saperne di più, consulta Informazioni sulle API e sui proxy API.
Creare un prodotto API
Un proxy API è l'endpoint HTTP su Apigee Edge che gli sviluppatori utilizzano per accedere ai tuoi servizi di backend. Sebbene sia possibile, in genere non rendi disponibili i singoli proxy API. Raggruppa invece uno o più proxy API in un prodotto API.
Un prodotto API è un pacchetto di proxy API combinato con un piano di servizi. Questo piano di servizi può impostare limiti di accesso ai proxy API, fornire sicurezza, consentire il monitoraggio e l'analisi e fornire funzionalità aggiuntive. I prodotti API sono anche il meccanismo centrale utilizzato da Edge per l'autorizzazione e il controllo dell'accesso alle tue API.
Hai una grande flessibilità nella creazione di prodotti API. Ad esempio, più prodotti API possono condividere lo stesso proxy API. La figura seguente mostra tre prodotti API. Tieni presente che tutti i prodotti consentono l'accesso al proxy API 3, ma solo il prodotto A consente l'accesso al proxy API 1.
Puoi impostare proprietà diverse per ogni prodotto API. Ad esempio, potresti rendere disponibile un prodotto API con un limite di accesso basso, ad esempio 1000 richieste al giorno, a un prezzo vantaggioso. Poi rilasci un altro prodotto API che fornisce l'accesso allo stesso proxy API, ma con un limite di accesso molto più elevato, a un prezzo più alto. In alternativa, puoi creare un prodotto API senza costi che consenta l'accesso in sola lettura ai tuoi servizi e poi vendere un prodotto API agli stessi proxy API che consenta l'accesso in lettura/scrittura.
Per saperne di più, consulta Gestire i prodotti API.
Consentire a un'app lato client di accedere al tuo prodotto API
Quando gli sviluppatori di app decidono di accedere ai tuoi servizi, devono prima registrare la loro app client con il tuo prodotto API.
Al momento della registrazione, uno sviluppatore di app riceve una chiave API che deve includere in ogni richiesta a un proxy API incluso nel prodotto API. La chiave viene autenticata e, se l'autenticazione ha esito positivo, la richiesta può accedere al tuo servizio di backend.
In qualsiasi momento, puoi revocare la chiave in modo che l'app client non abbia più accesso ai tuoi servizi. In alternativa, puoi definire un limite di tempo per una chiave in modo che lo sviluppatore debba aggiornarla dopo un periodo di tempo specifico.
Decidi tu come gestire le richieste di registrazione degli sviluppatori per accedere ai tuoi prodotti API. Utilizzando Apigee Edge Developer Services, puoi automatizzare la procedura di registrazione oppure utilizzare una procedura manuale per controllare l'accesso.
Creare prodotti API e renderli disponibili agli sviluppatori
- Crea uno o più proxy API che mappano gli URL disponibili pubblicamente ai tuoi servizi di backend servizi.
- Crea un prodotto API che raggruppi i tuoi proxy API.
- Esegui il deployment dei proxy API e del prodotto API.
- Informa gli sviluppatori che il prodotto API è disponibile.
Una volta che gli sviluppatori di app conoscono la disponibilità del tuo prodotto API:
- Registrano le loro app client con il tuo prodotto API.
- Ricevono una chiave API per il prodotto API.
- Inviano richieste ai tuoi servizi tramite i proxy API (raggruppati nel prodotto API) e passano la chiave API con ogni richiesta.
Componenti di Apigee Edge
Apigee Edge è composto da runtime API, monitoraggio e analisi e servizi per sviluppatori che insieme forniscono un'infrastruttura completa per la creazione, la sicurezza, la gestione, e le operazioni delle API.
La figura seguente mostra i servizi Edge:
Runtime API Edge
I servizi API Apigee Edge riguardano la creazione e l'utilizzo di API, sia che tu stia creando proxy API come fornitore di servizi sia che tu stia utilizzando API, SDK e altri servizi di utilità come sviluppatore di app.
Il server di gestione delle API fornisce strumenti per aggiungere e configurare i proxy API, configurare i prodotti API e gestire gli sviluppatori di app e le app client. Scarica molti problemi di gestione comuni dai servizi di backend. Quando aggiungi un proxy API, puoi applicare policy al proxy API per aggiungere sicurezza, limitazione della frequenza, mediazione, memorizzazione nella cache, e così via. Puoi anche personalizzare il comportamento del proxy API applicando script personalizzati, effettuando chiamate a API e servizi di terze parti e così via. Per saperne di più, consulta Informazioni sulle API e sui proxy API.
Se sei uno sviluppatore Node.js, puoi aggiungere facilmente i tuoi moduli Node.js a Edge per creare API e mashup API, sfruttando al contempo i vantaggi offerti da Edge, dalla trasformazione dei messaggi alla sicurezza fino all'analisi.
Monitoraggio e analisi di Edge
Apigee Edge API Analytics fornisce strumenti efficaci per visualizzare le tendenze di utilizzo a breve e lungo termine delle tue API. Puoi segmentare il pubblico in base ai principali sviluppatori e app, comprendere l'utilizzo per metodo API per sapere dove investire e creare report personalizzati sulle informazioni a livello aziendale o operativo.
Quando i dati passano attraverso Edge, vengono raccolti diversi tipi di informazioni predefiniti, tra cui URL, IP, ID utente per le informazioni sulle chiamate API, latenza, dati di errore e così via. Puoi creare policy per aggiungere altre informazioni, come intestazioni, parametri di ricerca e parti di una richiesta o risposta estratte da XML o JSON. Queste informazioni vengono raccolte in modo asincrono dal flusso di richiesta/risposta effettivo e pertanto non influiscono sulle prestazioni dell'API.
L'UI di gestione consente di visualizzare più metriche e dimensioni in un browser, come mostrato nella figura seguente:
Tuttavia, puoi anche accedere e controllare il servizio di analisi tramite un'interfaccia a riga di comando o tramite API RESTful. Per saperne di più, consulta Panoramica dell'analisi delle API.
Ecosistema per sviluppatori Edge
Apigee Edge fornisce servizi per sviluppatori che ti consentono di:
- Gestire la community di sviluppatori di app che utilizzano i tuoi servizi.
- Collaborare con sviluppatori interni ed esterni e formalizzare le relazioni con modelli finanziari.
- Eseguire l'onboarding degli sviluppatori e creare un portale per sviluppatori. Gli sviluppatori di app si connettono al tuo portale per accedere alla documentazione dell'API per saperne di più sui tuoi prodotti API disponibili pubblicamente e gestire le chiavi API.
Ogni cliente Edge può creare il proprio portale per sviluppatori, nel cloud o on-premise con Apigee Edge per Private Cloud.
Apigee Edge ti consente di creare due tipi di portali:
- Portale integrato , di cui è possibile eseguire il provisioning immediatamente. Consulta Creare il portale integrato.
- Portale basato su Drupal. Consulta Creare un portale basato su Drupal.
Monetizzazione
Le funzionalità di monetizzazione forniscono l'infrastruttura finanziaria e le relazioni per trasformare la tua community di sviluppatori in un canale effettivo per le tue risorse digitali. Con la monetizzazione, puoi creare una serie di piani tariffari che addebitano agli sviluppatori l'utilizzo dei tuoi prodotti API o ti consentono di pagare gli sviluppatori in scenari di condivisione delle entrate.
I piani includono piani prepagati, piani postpagati, piani a tariffa fissa, piani a tariffa variabile, piani "freemium", piani personalizzati per sviluppatori specifici, piani che coprono gruppi di sviluppatori e altro ancora. Inoltre, la monetizzazione include funzionalità di reportistica e fatturazione.
Per saperne di più, consulta Panoramica della monetizzazione.
Versioni di Edge
Apigee Edge è disponibile nelle seguenti versioni:
- Cloud pubblico: una versione SAAS ospitata in cui Apigee gestisce l' ambiente, consentendoti di concentrarti sulla creazione dei servizi e sulla definizione delle API per questi servizi.
- Cloud privato: un'installazione on-premise in cui controlli l' ambiente hardware e sei responsabile dell'installazione, dell'upgrade, della manutenzione e di altre procedure amministrative.
Se ti interessa la nostra versione Apigee hybrid, consulta i seguenti argomenti di Apigee X:
A livello funzionale, le versioni Cloud pubblico e Cloud privato sono molto simili. Tuttavia, la versione Cloud privato non supporta tutte le funzionalità della versione Cloud pubblico. Le funzionalità non supportate da Cloud privato includono:
- Target ospitati
- Estensioni
- Portali per sviluppatori integrati (Nota: i portali per sviluppatori basati su Drupal sono supportati)
- Monitoraggio delle API
- Sense
Per un elenco delle differenze tra le versioni, consulta Confrontare i prodotti Apigee.
Esistono anche piccole differenze tra le API, come descritto in Differenze tra l'API Edge per Cloud pubblico e l'API Cloud privato.
Cloud pubblico supporta account senza costi e a pagamento. Cloud privato richiede account a pagamento.
Per supportare completamente un'installazione on-premise, la versione Cloud privato include componenti come il server di gestione Apigee, un database NoSQL Apache Cassandra, un server OpenLDAP, un router di messaggi e un processore di messaggi.