Esta página foi traduzida pela API Cloud Translation.

Etapa 4: alterar o endpoint de destino

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

Confira a documentação da Apigee Edge.

Um proxy de API da Apigee tem dois endpoints: um de proxy e um de destino. O endpoint de proxy é a interface do cliente. Ele recebe solicitações de clientes e envia respostas de volta para eles. O endpoint de destino é a interface do produtor de API. Ele se comunica da Apigee com um produtor de API, como um serviço ou API de back-end. Para saber mais sobre endpoints, consulte O que é um proxy de API?

Nesta etapa, você vai mudar o endpoint de destino do proxy de API para https://mocktarget.apigee.net/xml, um recurso que retorna dados XML de teste. Depois de fazer a mudança, você vai reimplantar e testar o proxy de API revisado.

Apigee no console do Cloud

No console do Google Cloud , acesse a página Desenvolvimento de proxy > Proxies de API.

Acessar proxies de API
Verifique se o mesmo projeto do Google Cloud em que você criou o proxy de API está selecionado no menu suspenso na parte de cima da página.
Na tabela de proxies, selecione o proxy myproxy, criado na Etapa 1: criar um proxy de API.
Clique na guia Desenvolver.

Conhecer a visualização "Desenvolver"

No painel esquerdo da visualização Dsvelop, você pode fazer o seguinte:

Pesquise texto no proxy no campo Search proxy.
Adicionar novas políticas.
Adicionar endpoints de proxy e destino.
Adicionar outros recursos.

Se não quiser ver o painel à esquerda, recolha-o clicando no botão de fechar .

O painel à direita da visualização Develop exibe os editores visuais e de texto para o proxy:

O editor visual oferece uma visualização gráfica do fluxo de solicitação e resposta.
O editor de texto permite editar o XML do proxy ou do destino.

Editores de texto e recursos visuais com divisor selecionável.

Observações:

Clique e arraste o divisor entre os dois editores para cima ou para baixo para expandir a área de exibição de cada editor.
É possível expandir a área de exibição do editor visual clicando no botão de alternância à direita do editor de texto, que fecha o painel do editor de texto. Clique no botão ativar novamente para reabrir o painel do editor de texto.

Alterar o endpoint de destino

Para alterar o endpoint de destino do proxy:

Na páginaRevisão de proxy painel, selecionarEndpoints de destino > padrão.

Isso mostra um diagrama do endpoint de destino no editor visual:

Abaixo do editor visual, o código XML do endpoint de destino é exibido no editor de texto:
No editor de texto, mude <URL> para https://mocktarget.apigee.net/xml. (Anexe "/xml" ao URL atual.)

O novo URL é exibido abaixo:
```
...
<HTTPTargetConnection>
  <Properties/>
  <URL>https://mocktarget.apigee.net/xml</URL>
</HTTPTargetConnection>
...
```
Clique na seta ao lado de Salvar no canto superior direito do Editor de Proxy e selecione Salvar como nova revisão.
Para implantar as alterações, clique em Implantar.
Na caixa de diálogo Implantar, selecione a revisão e o ambiente em que a implantação será feita e clique em Implantar.

IU clássica da Apigee

Para alterar o endpoint de destino do proxy:

Faça login na IU da Apigee.
Selecione Desenvolver > Proxies de API.
Selecione seu proxy na lista para exibir os detalhes do proxy da API. Se você não vir seu proxy na lista, verifique se selecionou a organização correta, conforme descrito em Como alternar entre organizações.
Clique na guia Desenvolver:

Isso direciona você para o Editor de proxy de API. O Editor de proxy permite que você veja a estrutura do proxy da API e configure o fluxo dele. Um fluxo é apenas o caminho passo a passo que uma solicitação de proxy de API leva pela plataforma Apigee. Outros tutoriais cobrirão o conceito de fluxos.

No painel Navigator, selecione Target Endpoints > default > PreFlow:

A Apigee exibe as configurações do endpoint no painel Code:

<TargetEndpoint name="default">
  <Description/>
  <FaultRules/>
  <PreFlow name="PreFlow">
    <Request/>
    <Response/>
  </PreFlow>
  <PostFlow name="PostFlow">
    <Request/>
    <Response/>
  </PostFlow>
  <Flows/>
  <HTTPTargetConnection>
    <Properties/>
    <URL>https://mocktarget.apigee.net</URL>
  </HTTPTargetConnection>
</TargetEndpoint>

O endpoint de destino é definido pelo elemento <HTTPTargetConnection>.

Altere o URL para "https://mocktarget.apigee.net/xml". Anexe "/xml" ao URL atual.

O novo URL retorna um pequeno bloco de XML no corpo da resposta.

A configuração do endpoint agora terá a seguinte aparência:
```
...
<HTTPTargetConnection>
  <Properties/>
  <URL>https://mocktarget.apigee.net/xml</URL>
</HTTPTargetConnection>
...
```
Para salvar as alterações na configuração do proxy, clique no botão Salvar.

O Apigee salva suas alterações em uma nova revisão de proxy.
Para implantar a nova revisão, selecione Implantar em: teste e clique em Implantar 2.
Na caixa de diálogo de confirmação, clique em Implantar.
Se houver um erro, a Apigee salvará suas alterações, mas não implantará o proxy. No caso de um erro:
1. Corrija a configuração de proxy. A Apigee pode fornecer orientação de sintaxe como um pop-up.
2. Implante manualmente as alterações no ambiente test clicando em Implantação > teste se a Apigee não a implantar automaticamente.
É possível verificar se a revisão de proxy foi implantada com sucesso visualizando o status da revisão de implantação adjacente à lista suspensa "Implantar". Exemplo:

Testar o proxy

Para testar a revisão do proxy de API, chame o proxy da mesma forma que fez em Chamar um proxy de API.

Desta vez, o endpoint de simulação retorna o XML no corpo da resposta:

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <city>San Jose</city>
  <firstName>John</firstName>
  <lastName>Doe</lastName>
  <state>CA</state>
</root>

Agora que o proxy da API retorna dados XML, na próxima etapa, você adicionará uma política que converte XML em JSON.

1 2 3 4 (PRÓXIMO) Etapa 5: adicionar uma política