Questa pagina si applica ad Apigee e Apigee hybrid.
Visualizza la documentazione di Apigee Edge.
L'API Apigee può essere utilizzata per sviluppare e gestire in modo programmatico le API con un insieme di operazioni RESTful.
Puoi utilizzare l'API Apigee per integrare la gestione dei proxy API nel ciclo di vita dello sviluppo del software (SDLC) della tua organizzazione. Un utilizzo comune dell'API Apigee è scrivere script o codice che eseguono il deployment di proxy API o eseguono la migrazione di proxy API da un ambiente all'altro, nell'ambito di un processo automatizzato più ampio che esegue anche il deployment o la migrazione di altre applicazioni.
Per saperne di più, consulta l'API Apigee.
Attivazione dell'API Apigee
Assicurati di aver attivato l'API Apigee. Il modo più semplice per attivare un'API per il tuo progetto è utilizzare la console Google Cloud. Per informazioni dettagliate, vedi Passaggio 3: attivare le API.
Ottenere un token di accesso OAuth 2.0
L'API Apigee supporta OAuth 2.0 per l'autenticazione utente. Con OAuth 2.0, scambi le tue credenziali Google Cloud per un token di accesso che puoi utilizzare per effettuare chiamate sicure all'API Apigee. Una volta ottenuto un token, non dovrai più scambiare le tue credenziali fino alla scadenza del token.
Ottenere un token utilizzando le credenziali Google Cloud
Per ottenere un token utilizzando le tue credenziali Google Cloud:
- Autorizza gcloud ad accedere alla piattaforma Cloud con le tue credenziali utente Google:
gcloud auth login
- Ottieni un token per l'account attualmente attivo:
export TOKEN=$(gcloud auth print-access-token)
- Quando chiami un'API Apigee, passa il token di accesso nell'intestazione Authorization.
Ad esempio:
curl "https://apigee.googleapis.com/v1/organizations" -H "Authorization: Bearer $TOKEN"
Ottenere un token utilizzando una chiave dell'account di servizio Google Cloud
Per ottenere un token utilizzando una chiave dell'account di servizio per l'autorizzazione:
- Genera una chiave per il tuo account di servizio utilizzando la console Google Cloud, come descritto in Creare e gestire le chiavi degli account di servizio.
Un file JSON contenente le credenziali dell'account di servizio viene scaricato sul computer.
-
Imposta la variabile di ambiente
GOOGLE_APPLICATION_CREDENTIALS
sul percorso in cui si trova la chiave dell'account di servizio:export GOOGLE_APPLICATION_CREDENTIALS=your_sa_credentials_file.json
- Quando chiami un'API Apigee, utilizza Google Cloud CLI per aggiungere un token di accesso all'header Authorization. Ad esempio:
curl "https://apigee.googleapis.com/v1/organizations" -H "Authorization: Bearer $(gcloud auth application-default print-access-token)"
Impostazione delle variabili di ambiente per le richieste API Apigee
Gli esempi dell'API Apigee e dell'interfaccia alla gcloud CLI forniti nella documentazione utilizzano una o più delle variabili di ambiente definite nella tabella seguente.
Se imposti in anticipo le variabili di ambiente su valori significativi nel tuo ambiente, puoi copiare e incollare le richieste di esempio per eseguirle nel tuo ambiente con modifiche minime o nessuna.
Variabile di ambiente | Descrizione |
---|---|
$API |
Nome del proxy API. |
$APIPRODUCT |
Nome del prodotto API. |
$APP |
ID di un'app. |
$DEVELOPER_EMAIL |
Indirizzo email dello sviluppatore. |
$ENV |
Nome dell'ambiente, ad esempio test o prod . |
$ID |
ID risorsa. |
$KEY |
Chiave consumer. |
$NAME |
Nome della risorsa. |
$ORG |
La tua organizzazione Apigee. |
$REV |
Numero di revisione del proxy API. |
$SHAREDFLOW |
Nome del flusso condiviso. |
$TYPE |
Tipo di risorsa. |
Utilizzo di curl
Gli esempi in questa sezione utilizzano curl
per dimostrare come sviluppare applicazioni
utilizzando l'API Apigee. curl
è uno strumento a riga di comando open source per il trasferimento di dati con sintassi URL, che supporta protocolli comuni come HTTP e HTTPS.
La tabella seguente riassume le opzioni a riga di comando di curl utilizzate negli esempi.
Opzione | Descrizione |
---|---|
-d '{}' --data @filename |
Definisce il corpo della richiesta, che puoi passare direttamente o specificando un nome file. |
-F file=@filename
|
Definisce i dati basati su moduli che puoi passare specificando un nome file. |
-H |
Definisce un'intestazione di richiesta.
Devi passare le seguenti informazioni nell'intestazione della richiesta:
|
-X
|
Specifica il tipo di richiesta (GET, POST e così via). |
Ad esempio:
curl "https://apigee.googleapis.com/v1/organizations/$ORG/apis" \ -X GET \ -H "Authorization: Bearer $TOKEN"
Dove $TOKEN
è impostato sul tuo token di accesso OAuth 2.0, come descritto in Ottenere un token di accesso OAuth 2.0.