Etapa 3: chamar um proxy de API

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

Confira a documentação da Apigee Edge.

Agora que você criou um novo proxy, está pronto para testá-lo chamando o proxy. Se uma entrada do Sistema de Nomes de Domínio (DNS) (DNS, na sigla em inglês) tiver sido configurada para o nome do host do grupo de ambiente da sua organização, é possível chamar o proxy da seguinte maneira:

curl https://YOUR_ENV_GROUP_HOSTNAME/myproxy

em que o YOUR_ENV_GROUP_HOSTNAME é o nome do host de um grupo de ambientes que contém o ambiente em que o proxy foi implantado. Consulte Encontrar o nome do host do grupo de ambientes.

Uma chamada bem-sucedida para o proxy tem o seguinte resultado:

Hello, Guest!

Se o nome do host do grupo de ambiente foi configurado durante o provisionamento usando um serviço de caracteres curinga, como nip.io, você pode chamar o proxy sem ter uma entrada de DNS configurada. Exemplo:

curl https://IP_ADDRESS.nip.io/myproxy

Nesse caso, o nome do host do grupo de ambiente é IP_ADDRESS.nip.io, em que IP_ADDRESS é o endereço IP do host.

Caso você veja uma mensagem de erro, verifique o seguinte:

  • Se ocorrer um erro de tempo limite incomum, tente cancelar a implantação e reimplantar o novo proxy de API.
  • Se o host não puder ser resolvido, por exemplo, um erro 404 aparecer, verifique se você está usando o nome do host e do proxy corretos. É possível encontrar o nome do host na IU da Apigee. Acesse Administrador > Ambientes > Grupos para ver os nomes do host ou host.
  • Se você vir um erro de TLS/SSL, como um erro de handshake de SSL, entre em contato com o provedor de DNS para verificar se o registro A de DNS para o nome do host está configurado corretamente. Verifique se o registro tem o IP do balanceador de carga que foi criado durante o provisionamento da Apigee. Se você não souber qual é o IP, consulte Como determinar se o balanceador de carga do Cloud está configurado para um nome de host.
  • Se um erro de certificado TLS/SSL for exibido, talvez o certificado SSL associado ao balanceador de carga não tenha o nome de host correto e, portanto, esteja sendo rejeitado. O certificado foi criado durante o processo de provisionamento. As etapas de solução de problemas em Como determinar se o balanceador de carga do Cloud está configurado para um nome de host mostra como localizar e inspecionar o certificado.
  • Se não for possível solucionar o problema, entre em contato com a pessoa que provisionou a Apigee para receber mais ajuda.

Encontrar o nome do host do grupo de ambiente

Se você não souber o nome do host do grupo de ambiente, poderá encontrá-lo da seguinte maneira:

  1. Na IU da Apigee, selecione Administrador > Ambientes > Grupos.
  2. Procure uma linha que exiba o ambiente em que seu proxy está implantado. Por exemplo, se o ambiente for test-1, a linha poderá aparecer conforme mostrado abaixo:

    Painel de grupos de ambiente na IU da Apigee.

    O nome do host do grupo de ambientes é api-test.exco.com.

Nesse caso, o comando curl para chamar o proxy seria:

curl https://api-test.exco.com/myproxy

Na próxima etapa, você alterará o endpoint de destino para retornar dados XML do serviço de destino.

1 2 3 (NEXT) Etapa 4: alterar o endpoint de destino 5