Como criar um proxy de API

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

Confira a documentação da Apigee Edge.

Observação: em ambientes ativados para implantações de arquivo, não é possível desenvolver proxies de API usando a IU da Apigee, APIs ou gcloud. Para desenvolver proxies de API para implantações de arquivo usando a Apigee no VS Code, consulte Como desenvolver proxies de API usando a Apigee no VS Code.

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.
   Observação: se você vir a página Bem-vindo ao gerenciamento de APIs da Apigee, será necessário provisionar sua organização da Apigee antes de prosseguir.

   Depois de provisionar a Apigee, feche a interface e abra novamente a https://console.cloud.google.com/apigee.

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.

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

   

   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:

   

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

   

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

    

    Observação: se você não selecionar um ambiente de Implantação opcional abaixo, o botão no canto inferior direito vai ser nomeado como Criar
    Observação: depois de implantar uma revisão de proxy da API, não é possível editá-la. Para editar o proxy de API, crie e implante uma nova revisão.

    Por esse motivo, opte por criar o proxy de API sem implantá-lo em qualquer ambiente. É possível editar e implantar o proxy de API posteriormente, conforme descrito em Próximas etapas.

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

    

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

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

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:

• Adicione políticas, segurança e outros recursos da plataforma Apigee, conforme descrito em Noções básicas sobre APIs e proxies de API
• Implante-o no cluster, conforme descrito em Implantar um proxy de API.