Passaggio 6: collega un criterio

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza documentazione di Apigee Edge.

I criteri possono trasformare i formati dei messaggi, applicare il controllo dell'accesso, chiamare servizi remoti, autorizzare gli utenti, esaminare i contenuti dei messaggi per rilevare potenziali minacce e molto altro ancora. Per ulteriori informazioni, consulta la sezione Che cos'è una norma?

Gli endpoint proxy e target 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 delle richieste API. I criteri vengono allegati in diversi punti dei flussi di messaggi di richiesta e risposta come passaggi di elaborazione.

Nei passaggi seguenti, creerai un nuovo criterio e lo collegherai al tuo proxy API nel flusso di risposta di PreFlow per assicurarti che il criterio venga applicato prima che venga eseguita qualsiasi altra elaborazione. Il regolamento XMLtoJSON utilizzato in questo tutorial converte il payload del messaggio di risposta dell'API da XML a JSON.

1. Crea un criterio XMLtoJSON.
   1. Espandi il bundle del proxy API helloworld nella sezione Apigee, posiziona il cursore sopra la cartella policies e fai clic su .

      

      Si apre la procedura guidata Crea criterio.

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

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

   5. Modifica il criterio per impostare gli elementi <OutputVariable> e <Source> su response.
      Nota: collegherai il criterio al flusso di risposta nel proxy API <PreFlow>. nel passaggio successivo.

      <?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 il criterio all'endpoint proxy predefinito.
   1. Espandi la cartella proxies nel bundle 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>, come mostrato di seguito.

      <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. Per rieseguire il deployment dell'ambiente, posiziona il cursore sulla cartella dell'ambiente dev nella sezione Apigee e fai clic su .

   

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

   

5. Chiama l'API nella scheda Terminale.

   curl localhost:8998/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY

   La risposta XML viene convertita in JSON, come segue:

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

Complimenti! Hai collegato il criterio XMLtoJSON al tuo proxy API.

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

1 2 3 4 5 6 (SUCCESSIVO) Passaggio 7: esegui il deployment in un ambiente Apigee 8