Questa pagina si applica a Apigee e Apigee ibridi.
Visualizza la documentazione di
Apigee Edge.
Questo argomento elenca alcune caratteristiche di base dei proxy API, insieme a link per ulteriori informazioni.
Le API sono punti di contatto che consentono a un'applicazione di utilizzare le funzionalità di un'altra. Implementi l'API per creare API
In Apigee, implementi i proxy API configurando la logica del proxy API come sequenza di passaggi che vengono eseguiti in risposta a una richiesta del codice client. Esponi un proxy API ai client definendo endpoint che includono un URL con percorsi delle risorse, un verbo HTTP, requisiti del corpo e così via.
Sebbene si chiami proxy API, dal punto di vista del codice client è l'API.
Per una panoramica dei proxy API, consulta Informazioni sulle API e sui proxy API.
Sei tu a organizzare la sequenza del proxy API la logica utilizzando i flussi
In qualsiasi applicazione, i dati passano attraverso l'applicazione guidata dalla logica di condizione. In Apigee, il percorso di elaborazione è costituito da flussi. Un flusso è una sequenza di fasi (o "passaggi") che costituiscono il percorso di elaborazione di un proxy API. I flussi consentono ad Apigee di fornirti punti in cui applicare logica e comportamento in punti specifici dal client alla risorsa di backend e poi di nuovo al client.
Per saperne di più sui flussi, consulta Controllare come viene eseguito un proxy con i flussi.
Accedi ai dati di stato tramite le variabili di flusso create dai proxy API
Un proxy API ha accesso alle variabili che rappresentano lo stato di esecuzione. Puoi accedere a queste variabili dal file XML che configura i proxy e i criteri dell'API. Puoi accedervi anche quando estendi un proxy API con un linguaggio procedurale, come Java, JavaScript o Python.
Queste variabili sono conservate da Apigee. Alcune esistono per impostazione predefinita, di solito perché sono comuni a cosa fanno i proxy API (ad esempio perché fanno parte di una richiesta HTTP). Puoi anche creare le tue variabili per soddisfare un requisito logico.
Per ulteriori informazioni sulle variabili, consulta Gestione dello stato del proxy con il flusso variabili.
Puoi fare in modo che i proxy API eseguano in modo condizionale
Proprio come nella maggior parte dei linguaggi di programmazione, nei proxy API puoi fare in modo che il codice venga eseguito in modo condizionale. Le condizioni si basano spesso sullo stato del proxy API, a cui puoi accedere tramite le variabili di flusso. Per Ad esempio, puoi avere una condizione che controlla lo user agent, quindi elabora la richiesta di conseguenza.
Per ulteriori informazioni sull'esecuzione condizionale, consulta Condizioni con variabili di flusso.
Implementi la maggior parte della logica in un proxy API utilizzando i criteri
La maggior parte della logica aggiunta a un proxy API è pacchettizzata come criteri. Un criterio è un modello Apigee componente che incapsula la logica per un'area funzionale, come la sicurezza o la gestione del traffico. Puoi configurare un criterio con XML che imposti le proprietà per la logica sottostante. Sei tu a organizzare norme in una sequenza di "passaggi" all'interno di un flusso, in modo che il proxy API esegua la logica nel nel miglior modo possibile per gli obiettivi del proxy.
Per saperne di più sui criteri, consulta Che cos'è un criterio?.
Puoi includere insiemi riutilizzabili di funzionalità
Quando il proxy API include una logica che verrà utilizzata da più punti del codice, come altri proxy API, puoi raccogliere questa logica per le chiamate da più punti. Ad esempio: puoi raggruppare la logica di sicurezza in un flusso condiviso chiamato da altri proxy API, riducendo i duplicati attraverso i proxy API.
Per ulteriori informazioni sui flussi condivisi, consulta Riutilizzabile di flussi condivisi. Per saperne di più sul concatenamento dei proxy API, consulta Chaining dei proxy API insieme.
Puoi eseguire il debug di un proxy con lo strumento di debug
Apigee include uno strumento di debug che puoi utilizzare per esaminare l'esecuzione del proxy API flusso quando debug e test. Lo strumento presenta visivamente ogni passaggio del proxy API eseguito per richiesta. Come in un debugger, in ogni passaggio puoi visualizzare l'elenco dei valori delle variabili che compongono lo stato del proxy API.
Per ulteriori informazioni sul debug con lo strumento di debug, vedi Strumento di debug.
Gestisci gli errori del proxy API come errori
Configurando un gestore degli errori, puoi personalizzare l'errore restituito a un client API. I gestori degli errori ti consentono di controllare i messaggi di errore, indipendentemente dal fatto che l'errore provenga dal tuo codice o da un componente incluso (ad esempio un criterio).
Per saperne di più, consulta la sezione Gestione degli errori.