Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Utilizzo dei proxy API di esempio

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Prerequisiti

Avrai bisogno di un account su http://enterprise.apigee.com. Puoi registrarti per un account di prova all'indirizzo http://accounts.apigee.com/accounts/sign_up.

Per utilizzare gli esempi, devi disporre anche di:

Strumento	Descrizione
Git	Gli esempi si trovano su GitHub. Se non hai installato Git, consulta le istruzioni di configurazione di Git di GitHub. Se non vuoi installare Git, puoi sfogliare i file e scaricare un file ZIP da https://github.com/apigee/api-platform-samples.
Python	Python è necessario per eseguire lo strumento di deployment di Apigee. Python è presente nella maggior parte degli ambienti Linux , su un Mac con XCode installato, su una macchina Windows con Cygwin installato e in molti altri luoghi. Per ottenere Python, consulta la pagina di download di Python.
`curl`	Gli script di configurazione di esempio utilizzano anche `curl`. Assicurati che `curl` sia installato e disponibile nel tuo percorso (esegui il comando `which curl` per verificare se è disponibile sul tuo sistema).
`dos2unix`	Se esegui Cygwin su Windows, potresti aver bisogno anche dell'utilità `dos2unix`. (Il programma di installazione di Cygwin ti consente di installare l'utilità.)

Scaricare gli esempi

Per ottenere i file di esempio, utilizza git clone come mostrato nell'esempio seguente:

git clone https://github.com/apigee/api-platform-samples.git

Importare ed eseguire il deployment dei proxy API di esempio

Importa ed esegui il deployment degli esempi dalla riga di comando:

Dopo aver scaricato gli esempi, vai alla directory /setup, come mostrato nell'esempio seguente:
```
cd setup
```
Nella directory /setup, individua il file setenv.sh.
Modifica questo file per impostare la tua organizzazione, l'indirizzo email associato al tuo nome utente, e l'ambiente (prod o test) in cui vuoi eseguire il deployment dei proxy API.
Dopo aver modificato setenv.sh, esegui quanto segue:
```
sh deploy_all.sh
```
Questo script esegue il deployment di tutti gli esempi di proxy API nella tua organizzazione. (La procedura richiede 3-4 minuti.) Segui le istruzioni per eseguire il deployment di prodotti API, sviluppatori e app (utilizzati per OAuth).
Al termine dello script di deployment, vai alla directory sample-proxies. Nella directory sample-proxies, troverai una directory per ogni proxy di esempio. In ogni directory è presente un file README.md con informazioni sull'esecuzione dell'esempio e due script che ti aiutano a apportare piccole modifiche agli esempi, a eseguire il deployment e poi a richiamare l'esempio per vedere l'effetto della modifica:
- invoke.sh: esegui questo script per richiamare la versione di cui è stato eseguito il deployment del proxy API proxy.
- deploy.sh: esegui questo script per eseguire il deployment del proxy API dopo aver apportato modifiche.

Richiamare i proxy API di esempio

Ogni proxy di esempio ha uno script shell associato che può essere utilizzato per richiamare il proxy API dopo averne eseguito il deployment.

Dalla directory /sample-proxies/proxy_name, esegui quanto segue:

sh invoke.sh

Viene richiamato il proxy in esecuzione nell'ambiente di test della tua organizzazione.

Risoluzione dei problemi

Per informazioni sulla risoluzione dei problemi, consulta quanto segue:

Modificare e riutilizzare i proxy API di esempio

L'utilizzo tipico dei proxy di esempio consiste nel modificarli, eseguirne il deployment e richiamarli. In questo modo puoi apportare piccole modifiche e poi vedere l'effetto sul messaggio di risposta.

Per modificare un proxy API di esempio in modo che punti a un servizio di backend diverso, modifica il file di configurazione XML nella seguente posizione:

/apiproxy/targets/target_name.xml

Ad esempio, per fare in modo che l'esempio della chiave API punti al tuo servizio di backend, individua questo file:

/apikey/apiproxy/targets/default.xml

Se la configurazione predefinita punta a http://mocktarget.apigee.net, ad esempio:

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <!-- This is where we define the target. For this sample we just use a simple URL. -->
    <URL>http://mocktarget.apigee.net</URL>
  </HTTPTargetConnection>
</TargetEndpoint>

e il tuo servizio di backend è disponibile all'indirizzo http://api.myproject.com/, quindi modifica la configurazione in modo che sia simile alla seguente:

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <!-- This is where we define the target. For this sample we just use a simple URL. -->
    <URL>http://api.myproject.com/</URL>
  </HTTPTargetConnection>
</TargetEndpoint>

Dopo aver salvato le modifiche, esegui il deployment del proxy API come mostrato nell'esempio seguente:

sh deploy.sh

Gli altri proxy API possono essere modificati nello stesso modo per utilizzare la funzionalità del proxy API rispetto ai servizi di destinazione esistenti. In alcuni casi, tuttavia, il comportamento del proxy API dipende da formati di messaggi specifici, pertanto i proxy potrebbero richiedere modifiche di configurazione aggiuntive.