Etapa 6: anexe uma política

Esta página se aplica à Apigee e à Apigee híbrida.

Confira a documentação da Apigee Edge.

As políticas da Apigee podem transformar formatos de mensagem, aplicar o controle de acesso, chamar serviços remotos, autorizar usuários, examinar o conteúdo das mensagens em busca de possíveis ameaças e muito mais. Para mais informações, consulte O que é uma política?

Os endpoints de proxy e de destino definem um pipeline para o processamento de mensagens de solicitação e resposta, chamados de fluxos de solicitação e resposta. Os fluxos são estágios sequenciais ao longo do caminho de processamento da solicitação da API. As políticas são anexadas em pontos diferentes nos fluxos de mensagens de solicitação e resposta como etapas de processamento.

Nas etapas a seguir, você cria uma nova política e a anexa ao proxy de API no fluxo de resposta PreFlow para garantir que a política seja aplicada antes de qualquer outro processamento ser realizado. A política XMLtoJSON usada neste tutorial converte o payload da mensagem de resposta da API de XML para JSON.

1. Crie uma política XMLtoJSON.
   1. Expanda o pacote do proxy de API helloworld, posicione o cursor sobre a pasta políticas e clique em .

      

      O assistente Criar política é aberto.

   2. Selecione Mediação como a categoria de política.
   3. Selecione XML para JSON como o tipo de política.
   4. Digite XMLtoJSON como o nome da política e clique em Enter.

      A política é adicionada à pasta /policies do proxy de API e aberta no editor.

   5. Clique em XMLtoJSON.xml para editar a política. Defina os elementos <OutputVariable> e <Source> como response e salve as mudanças.
      Observação: você anexará a política ao fluxo de resposta no proxy de API PreFlow na próxima etapa.

      <?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. Anexe a política ao endpoint do proxy padrão.
   1. Expanda a pasta proxies no pacote de proxy da API helloworld e clique em default.xml para abrir o arquivo no editor.
   2. Adicione um elemento <Step> que faça referência à política XMLtoJSON ao fluxo <Response> no proxy de 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. Salve suas alterações no arquivo.
3. Para reimplantar o ambiente, posicione o cursor sobre a pasta do ambiente dev e clique em .

   

4. Quando receber a solicitação para selecionar o pacote de teste a ser exportado, clique em Implantar sem um pacote de teste, porque esse pacote já foi exportado.

   

5. Chame a API na guia Terminal.

   curl 0:8998/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY

   A resposta XML é convertida em JSON da seguinte maneira:

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

Parabéns! Você anexou a política XMLtoJSON ao proxy da API.

Em seguida, implante a API como um arquivo em um ambiente da Apigee para testes de integração e lançamento de produção.

1 2 3 4 5 6 (A SEGUIR) Etapa 7: implantação em um ambiente da Apigee 8