Como criar um proxy de API

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

Confira a documentação da Apigee Edge.

Crie um proxy na IU da Apigee ou usando a API, conforme descrito nas seções a seguir.

Apigee no console do Cloud

Para criar um proxy na Apigee no Console do Cloud:

  1. Abra https://console.cloud.google.com/apigee em um navegador.
  2. No painel de navegação à esquerda, clique em Desenvolvimento de proxy > Proxys de API.
  3. No painel Proxy de API, clique em + Criar.
  4. No painel Criar um proxy, em Modelo de proxy, selecione Proxy reverso (mais comum).
  5. Em Detalhes do proxy, insira o seguinte:
    • Nome do proxy: insira um nome para o proxy, como myproxy.
    • Caminho base: definido automaticamente para o valor inserido para Proxy name. Caminho base faz parte do URL usado para fazer solicitações à API. A Apigee usa o URL para corresponder e rotear solicitações recebidas para o proxy de API apropriado.
    • Descrição (opcional): insira uma descrição para o novo proxy de API, como "Como testar a Apigee com um proxy simples".
    • Destino (API existente): insira https://mocktarget.apigee.net. Isso define o URL de destino que a Apigee 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.
    • Clique em Próxima.
  6. Clique em Próxima.
  7. Implantar (opcional):
    • Ambientes de implantação: opcional. Use as caixas de seleção para escolher um ou mais ambientes em que o proxy vai ser implantado. Se preferir não implantar o proxy neste ponto, deixe o campo Ambientes de implantação em branco. O proxy poderá ser implantado posteriormente.
    • Conta de serviço: opcional Anexe uma conta de serviço à implantação para permitir que seu proxy acesse os serviços do Google Cloud, conforme especificado no papel e nas permissões da conta de serviço.
  8. Clique em Criar.

A Apigee cria o novo proxy e exibe um resumo dos detalhes do proxy na visualização Resumo do proxy.

Painel de resumo "myproxy".

Se você optar por implantar o proxy, a seção Implantações exibe o número de revisão, que é 1 na primeira implantação. A coluna Status exibe os ambientes em que o proxy está implantado com um indicador de status verde.

Apigee clássica

Para criar um proxy de API simples na interface clássica da Apigee:

  1. Faça login na IU da Apigee.
  2. Clique em API Proxies na visualização principal.
  3. Na lista suspensa Environment, selecione o ambiente em que você quer criar um novo proxy de API.

    A IU híbrida exibe uma lista de proxies de API para esse ambiente. Se você ainda não tiver criado nenhum proxy, a lista estará vazia.

  4. Clique em Criar nova.

    O assistente de criação de proxy será iniciado.

  5. Clique em Proxy reverso (mais comum).

    Um proxy reverso

    A página Proxy details é exibida.

  6. Defina seu proxy com as seguintes configurações:
    • Nome: insira getstarted. Se já existir um proxy com esse nome, escolha um nome diferente.
    • Base Path: deixe este conjunto definido como /getstarted. Caminho base faz parte do URL usado para fazer solicitações à API. A Apigee usa o URL para corresponder e rotear solicitações recebidas para o proxy de API apropriado.
    • Description (opcional): insira uma descrição para o novo proxy da API, como Get started API proxy.
    • Destino (API existente): insira https://mocktarget.apigee.net. Isso define o URL de destino que a Apigee invoca em uma solicitação para o proxy da 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 da API precisam ser semelhantes a este:

    Detalhes do proxy de API

  7. Clique em Próxima.
  8. Na visualização Common policies, em Security: Authorization, selecione Pass through (no authorization).

    Seleção de passagem

  9. Clique em Próxima.
  10. Na página Summary, selecione os ambientes de implantação, se quiser, e clique em Create and deploy.

    Create and
      deploy

    Seu novo proxy de API é criado e implantado no ambiente selecionado.

    Tela de implantação
    bem-sucedida

  11. Clique em Editar proxy para exibir a guia "Visão geral" no Editor de Proxy.
  12. Editar lista de
      proxy

Na lista de proxies da API, o status de implantação do proxygetstarted é verde para o ambiente test.

Mostra a lista de proxies da API. O status da implantação getstarted é verde.

API Apigee

Crie um proxy de API na organização da Apigee emitindo uma solicitação POST para o seguinte recurso:

https://apigee.googleapis.com/v1/organizations/$ORG/apis

Defina o nome do proxy de API usando o parâmetro de consulta name. Restrinja os caracteres usados no nome ao seguinte: A-Za-z0-9._\-$ %

Se quiser, importe um pacote de configuração de proxy da API seguindo estas etapas:

  • Defina o parâmetro de consulta action como import.
  • Defina o cabeçalho Content-type como multipart/form-data.
  • Passe o nome do pacote de configuração de proxy da API em seu sistema de arquivos local.

O exemplo a seguir demonstra como criar um proxy de API importando um pacote de configuração de proxy de API (helloworld-config.zip) no seu sistema de arquivos local usando a API.

curl "https://apigee.googleapis.com/v1/organizations/$ORG/apis?name=helloworld&action=import" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: multipart/form-data" \
  -F "file=@helloworld-config.zip"

Em que $TOKEN está definido como seu token de acesso OAuth 2.0, conforme descrito em Como receber um token de acesso OAuth 2.0. Para informações sobre as opções de curl usadas neste exemplo, consulte Como usar curl. Para uma descrição das variáveis de ambiente usadas, consulte Como definir variáveis de ambiente para solicitações de API da Apigee.

Veja a seguir um exemplo de saída:

{
  "basepaths": [
    "/helloworld"
  ],
  "configurationVersion": {
    "majorVersion": 4
  },
  "createdAt": "1559145292799",
  "displayName": "helloworld",
  "entityMetaDataAsProperties": {
    "bundle_type": "zip",
    "subType": "Proxy",
    "lastModifiedAt": "1559145292799",
    "createdAt": "1559145292799"
  },
  "lastModifiedAt": "1559145292799",
  "name": "helloworld",
  "policies": [
    "verify-api-key",
    "remove-query-param-apikey",
    "OAuth-v20-1"
  ],
  "proxies": [
    "default"
  ],
  "proxyEndpoints": [
    "default"
  ],
  "resourceFiles": {},
  "targetEndpoints": [
    "default"
  ],
  "targets": [
    "default"
  ],
  "type": "Application",
  "revision": "1",
  "description": "Hello world"
}

Para mais informações sobre como criar um proxy de API, consulte o método apis.create na API da Apigee. Para ver todos os métodos disponíveis para proxies de API, consulte API Proxies de API.

Próximas etapas

Depois de criar um proxy de API simples, normalmente uma das seguintes ações é feita: