Etapa 4: teste a API

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

Confira a documentação da Apigee Edge.

Para testar a API helloworld implantada, clique na guia Terminal na Apigee no Cloud Code e digite a seguinte chamada de curl:

curl 0:8998/helloworld

A seguinte mensagem de erro é exibida:

Como chamar a API na guia de terminal e receber um erro de autorização

Como você ativou a autenticação baseada em chave de API ao criar o proxy da API, será necessário transmitir uma chave de API usando o parâmetro de consulta apikey ao chamar a API.

Para obter uma chave de API, você precisa criar um pacote de teste e configurar os seguintes recursos de teste:

  • Produto de API usado para agrupar a API e disponibilizá-la aos desenvolvedores

  • desenvolvedor que criará um aplicativo para acessar a API

  • App do desenvolvedor que permitirá o acesso à API usando uma chave de API

Crie e exporte recursos de teste, receba a chave de API e teste novamente a API.

  1. Crie um pacote de teste:
    1. Posicione o cursor sobre a pasta tests na seção da Apigee e clique em Ícone de criação.

      + é exibido quando você posiciona o cursor sobre a pasta de testes

      O assistente "Criar pacote de teste" é aberto.

    2. Digite mytestbundle no nome do pacote de teste e pressione Enter.

      O pacote de teste foi criado.

    3. Expanda a pasta mytestbundle na seção da Apigee para visualizar seu conteúdo.

      Pasta de teste com arquivos developerapps.json, developers.json, maps.json e products.json

  2. Configure o recurso de teste do produto da API:
    1. Posicione o cursor sobre o arquivo products.json no Apigee Explorer e clique em Ícone de criação.

      + é exibido quando você posiciona o cursor sobre products.json

      O assistente "Criar produto de API" é aberto.

      Primeira página do assistente de criação de produtos de API

    2. Digite myproduct para ver o nome do produto da API e pressione Enter para confirmar.
    3. Digite myproduct para a descrição do produto da API e pressione Enter para confirmar.
    4. Selecione helloworld para adicionar o proxy da API ao produto da API e clique em helloworld.

      O arquivo products.json é aberto no editor com o novo produto de API configurado, conforme mostrado abaixo:

      [
        {
          "attributes": [
            {
              "name": "sample_attribute_0",
              "value": "sample_attribute_value_0"
            }
          ],
          "scopes": [],
          "environments": [],
          "apiResources": [
            "/",
            "/*",
            "/**"
          ],
          "quota": "100",
          "quotaInterval": "1",
          "quotaTimeUnit": "minute",
          "name": "myproduct",
          "displayName": "myproduct",
          "proxies": [
            "helloworld"
          ]
        }
      ]
  3. Configure o recurso de teste do desenvolvedor:
    1. Posicione o cursor sobre o arquivo developers.json no Apigee Explorer e clique em Ícone de criação.

      + é exibido quando você posiciona o cursor sobre developers.json

      O assistente Criar desenvolvedor será aberto.

      Primeira página do assistente de criação de produtos de API

    2. Digite os seguintes valores nos prompts e pressione Enter para confirmar e continuar:
      • E-mail do desenvolvedor: ahamilton@example.com
      • Nome de usuário: ahamilton
      • Nome: Alex
      • Sobrenome: Hamilton

      O arquivo developers.json é aberto no editor com o novo desenvolvedor configurado, conforme mostrado abaixo:

      [
        {
          "attributes": [
            {
              "name": "sample_attribute_0",
              "value": "sample_attribute_value_0"
            }
          ],
          "email": "ahamilton@example.com",
          "userName": "ahamilton",
          "firstName": "Alex",
          "lastName": "Hamilton"
        }
      ]
  4. Configure o recurso de teste do aplicativo do desenvolvedor:
    1. Posicione o cursor sobre o arquivo developerapps.json na seção da Apigee e clique em Ícone de criação.

      + é exibido quando você posiciona o cursor sobre developerapps.json

      O assistente "Criar aplicativo de desenvolvedor" é aberto.

      Primeira página do assistente de criação de produtos de API

    2. Selecione ahamilton@example.com como proprietário do aplicativo.
    3. Digite os seguintes valores no próximo conjunto de prompts e pressione Enter para confirmar e continuar:
      • Nome do aplicativo: myapp
      • Descrição: myapp
      • Callback URL: deixe em branco
    4. Selecione myproduct para adicioná-lo ao app e clique em OK.
    5. Selecione nunca como o valor da expiração.

      O arquivo developerapps.json é aberto no editor com o novo app configurado, conforme mostrado abaixo:

      [
        {
          "attributes": [
            {
              "name": "sample_attribute_0",
              "value": "sample_attribute_value_0"
            }
          ],
          "developerEmail": "ahamilton@example.com",
          "name": "myapp",
          "displayName": "myapp",
          "callbackUrl": "",
          "apiProducts": [
            "myproduct"
          ],
          "expiryType": "never"
        }
      ]
  5. Exportar os recursos de teste para o Apigee Emulator.

    Na seção da Apigee, posicione o cursor sobre o pacote de teste mytestbundle e clique em Ícone de exportar teste.

    Recursos ativos de teste, incluindo produtos, desenvolvedores e aplicativos de desenvolvedor de API

    Os recursos de teste ativos aparecem na seção de emuladores da Apigee, como mostrado na figura a seguir.

    Recursos ativos de teste, incluindo produtos, desenvolvedores e aplicativos de desenvolvedor de API

  6. Na seção Emuladores da Apigee, em Recursos de teste ativos, clique em Aplicativos de desenvolvedor ativos.

    O arquivo de configuração de aplicativos do desenvolvedor ativo será aberto no editor. O arquivo contém credenciais de myproduct, conforme destacado na figura a seguir.

    Aplicativos do desenvolvedor com o valor consumerKey destacado.

  7. Copie o valor consumerKey (sem as aspas) do produto da API myproduct.
  8. Transmita a chave de API na chamada de curl usando o parâmetro de consulta apikey da seguinte maneira:
    curl 0:8998/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY

    A seguinte resposta é retornada:

    Hello, Guest!

Parabéns! Você executou uma API no ambiente local.

Na próxima etapa, você aprenderá a alterar o endpoint de destino.

1 2 3 4 (A SEGUIR) Etapa 5: alterar o endpoint de destino 6 7 8