Passaggio 6: collega un criterio

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Le policy Apigee possono trasformare i formati dei messaggi, applicare controllo dell'accesso, chiamare servizi remoti, autorizzare gli utenti, esaminare i contenuti dei messaggi per potenziali minacce e molto altro ancora. Per ulteriori informazioni, consulta Che cosa sono le norme?

Gli endpoint proxy e di destinazione definiscono una pipeline per l'elaborazione dei messaggi di richiesta e risposta denominata flussi di richiesta e risposta. I flussi sono fasi sequenziali lungo il percorso di elaborazione della richiesta API. Le policy vengono associate in punti diversi dei flussi di messaggi di richiesta e risposta come passaggi di elaborazione.

Nei passaggi successivi, crei una nuova norma e la colleghi al proxy API nel flusso di risposta PreFlow per assicurarti che venga applicata prima di qualsiasi altra elaborazione. Il XMLtoJSON policy utilizzato in questo tutorial converte il payload del messaggio di risposta dell'API da XML a JSON.

1. Crea una policy XMLtoJSON.
   1. Espandi il bundle del proxy API helloworld, posiziona il cursore sulla cartella policies e fai clic su .

      

      Si apre la procedura guidata Crea policy.

   2. Seleziona Mediazione come categoria delle norme.
   3. Seleziona XML to JSON come tipo di policy.
   4. Inserisci XMLtoJSON come nome del criterio e fai clic su Invio.

      Il criterio viene aggiunto alla cartella /policies per il proxy API e aperto nell'editor.

   5. Fai clic su XMLtoJSON.xml per modificare la policy. Imposta gli elementi <OutputVariable> e <Source> su response e salva le modifiche.
      Nota: nel passaggio successivo, collegherai il criterio al flusso response in PreFlow del proxy API.

      <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
      <XMLToJSON async="false" continueOnError="false" enabled="true" name="XMLtoJSON">
          <DisplayName>XMLtoJSON</DisplayName>
          <Properties/>
          <Format>yahoo</Format>
          <OutputVariable>response</OutputVariable>
          <Source>response</Source>
      </XMLToJSON>

2. Collega la policy all'endpoint proxy predefinito.
   1. Espandi la cartella proxies nel bundle di proxy API helloworld e fai clic su default.xml per aprire il file nell'editor.
   2. Aggiungi un elemento <Step> che fa riferimento al criterio XMLtoJSON al flusso <Response> nel proxy API <PreFlow>:

      <ProxyEndpoint name="default">
         <PreFlow name="PreFlow">
            <Request>
               <Step>
                  <Name>verify-api-key</Name>
               </Step>
               <Step>
                  <Name>remove-query-param-apikey</Name>
               </Step>
               <Step>
                  <Name>impose-quota</Name>
               </Step>
            </Request>
            <Response>
               <Step>
                  <Name>XMLtoJSON</Name>
               </Step>
            </Response>
         </PreFlow>
       ...
      </ProxyEndpoint>

   3. Salva le modifiche apportate al file.
3. Per eseguire nuovamente il deployment dell'ambiente, posiziona il cursore sulla cartella dell'ambiente dev e fai clic su .

   

4. Quando ti viene chiesto di selezionare un pacchetto di test da esportare, fai clic su Esegui il deployment senza un pacchetto di test perché il pacchetto di test è già stato esportato.

   

5. Chiama l'API nella scheda Terminale.

   curl 0:8998/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY

   La risposta XML viene convertita in JSON nel seguente modo:

   {
     "root": {
       "city": "San Jose",
       "firstName": "John",
       "lastName": "Doe",
       "state": "CA"
     }
   }

Complimenti! Hai collegato correttamente la policy XMLtoJSON al proxy API.

Successivamente, eseguirai il deployment dell'API come archivio in un ambiente Apigee per i test di integrazione e il rilascio della produzione.

1 2 3 4 5 6 (NEXT) Step 7: Deploy to an Apigee environment 8