Passaggio 6: collega un criterio

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

I criteri Apigee possono trasformare i formati dei messaggi, applicare 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 Che cos'è un criterio?

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 punti diversi dei flussi di messaggi di richiesta e risposta come passaggi di elaborazione.

Nei passaggi che seguono, crei un nuovo criterio e lo colleghi al proxy API nel flusso di risposta PreFlow per assicurarti che venga applicato prima di 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 proxy API helloworld, posiziona il cursore sulla cartella policies e fai clic su .

      

      Viene visualizzata la procedura guidata Crea criterio.

   2. Seleziona Mediazione come categoria delle norme.
   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 e aperto nell'editor.

   5. Fai clic su XMLtoJSON.xml per modificare le norme. Imposta gli elementi <OutputVariable> e <Source> su response e salva le modifiche.
      Nota: nel passaggio successivo collegherai il criterio al flusso di risposta 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 il criterio 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 bundle di test da esportare, fai clic su Esegui il deployment senza un bundle di test perché il bundle 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, come segue:

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

Complimenti! Hai collegato correttamente il criterio XMLtoJSON al 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 (AVANTI) Passaggio 7: esegui il deployment in un ambiente Apigee 8