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 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.

Crie uma política XMLtoJSON.
1. Expanda o pacote do proxy da API helloworld na seção da Apigee, 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 na seção da Apigee e aberta no editor.
5. Edite a política para definir os elementos <OutputVariable> e <Source> como response.
  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>
```

Anexe a política ao endpoint do proxy padrão.

Expanda a pasta proxies no pacote de proxy da API helloworld e clique em default.xml para abrir o arquivo no editor.

Adicione um elemento <Step> que faça referência à política XMLtoJSON ao fluxo <Response> no proxy da API <PreFlow>, conforme mostrado abaixo.

<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>

Para reimplantar o ambiente, posicione o cursor sobre a pasta do ambiente de desenvolvimento na seção da Apigee e clique em .
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.

Chame a API na guia Terminal.

curl localhost: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