Etapa 1: criar um proxy de API

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
info

Esta seção explica como criar um proxy de API simples.

Edge

Para criar um proxy de API usando a interface do Edge:

  1. Faça login em apigee.com/edge.
  2. Clique em API Proxies na janela principal:

  3. Clique em +Proxy.

    Criar proxy

    A Apigee mostrará instruções para você criar um proxy novo. Primeiro, selecione o tipo de proxy:

  4. Clique em Proxy reverso (mais comum).

    A Apigee mostra a página Proxy details.

  5. Configure os detalhes do proxy da seguinte maneira:
    • Name:digite getstarted. Se já existir um proxy com esse nome, use outro.
    • Base path:verifique se ele está definido como /getstarted.

      O caminho base faz parte do URL usado para fazer solicitações à API. O Edge usa o URL para corresponder e rotear solicitações de entrada para o proxy de API apropriado.

    • Descrição (opcional): insira uma descrição para o novo proxy de API, como Proxy de primeiros passos.
    • Target (Existing API): digite https://mocktarget.apigee.net. Isso define o URL de destino que o Apigee Edge invoca em uma solicitação para o proxy de API.

      O serviço simulado está hospedado na Apigee e retorna dados simples. Ele não requer nenhuma chave de API nem um token de acesso.

    Os detalhes do proxy precisam ser semelhantes a este:

  6. Clique em Próxima.
  7. Na página Common policies, em "Security: Authorization", verifique se a opção Pass through (no authorization) está selecionada e clique em Next.

  8. Na página Virtual hosts, selecione default e secure e clique em Next.
  9. Na página Summary, verifique se o ambiente Test está selecionado em Optional Deployment e clique em Create and deploy:

    A Apigee cria seu novo proxy de API e o implanta no ambiente de teste:

  10. Clique em Edit proxy para mostrar a página Visão geral para o proxy de API:

    Observe que, se você expandir o [ + ], a interface mostrará os URLs HTTP e HTTPS do ambiente de teste:

    Como resultado, você pode enviar solicitações para qualquer um deles, mas este tutorial usa HTTPS.

Edge clássico (nuvem privada)

Para criar um proxy de API usando a interface do Edge clássico:

  1. Faça login em http://ms-ip:9000, em que ms-ip é o endereço IP ou o nome DNS do nó do servidor de gerenciamento.
  2. Clique em API Proxies na janela principal:

  3. Clique em + API Proxy no canto superior direito:

    Criar proxy

    A Apigee mostrará instruções para você criar um proxy novo. A primeira decisão é o tipo de proxy:

  4. Selecione Reverse proxy (most common) e clique em Next.

    A Apigee mostra a tela Details.

  5. Defina seu proxy com as seguintes configurações:
    • Proxy Name:digite "getstarted". Se já existir um proxy com esse nome, escolha outro.
    • Proxy Base Path:verifique se ele está definido como "/getstarted".

      O Caminho base do proxy faz parte do URL usado para fazer solicitações à API. O Edge usa o URL para corresponder e rotear solicitações de entrada para o proxy de API apropriado.

    • Existing API:digite "https://mocktarget.apigee.net". Isso define o URL de destino que o Apigee Edge invoca em uma solicitação para o proxy de API.

      O serviço simulado está hospedado na Apigee e retorna dados simples. Ele não requer nenhuma chave de API nem um token de acesso.

    • (Opcional) Descrição: digite uma descrição para o novo proxy de API, como "Proxy de primeiros passos".

    Os detalhes do proxy precisam ser semelhantes a este:

  6. Clique em Próxima.
  7. Na tela Security , selecione Pass through (none) como a opção de segurança e clique em Next:

  8. Na tela Virtual Hosts, aceite as seleções padrão e clique em Next.
  9. Na tela Build, verifique se o ambiente test está selecionado ao lado de Deploy Environments e clique em Build and Deploy:

    A Apigee cria seu novo proxy de API e o implanta no ambiente de teste:

  10. Clique em View getstarted proxy in the editor para mostrar a página Visão geral para o proxy de API:

    Observe que, se você expandir o [ + ], a interface mostrará os URLs HTTP e HTTPS do ambiente de teste:

    Como resultado, você pode enviar solicitações para qualquer um deles, mas este tutorial usa HTTPS.

Próxima etapa

Etapa 1 Etapa 2: testar o novo proxy Etapa 3 Etapa 4