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

Observação: os exemplos nesta seção usam 0 como valor do host e 8998 como o valor da porta. É possível configurar os valores da porta, conforme descrito em Como gerenciar o emulador da Apigee. Se você receber um erro ao usar 0, substitua localhost por 0:

curl localhost: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.

Crie um pacote de teste:
1. Posicione o cursor sobre a pasta tests na seção da Apigee e clique em .
  
  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.
Configure o recurso de teste do produto da API:
1. Posicione o cursor sobre o arquivo products.json no Apigee Explorer e clique em .
  
  O assistente "Criar produto de API" é aberto.
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 OK.
  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"
    ]
  }
]
```
Configure o recurso de teste do desenvolvedor:
1. Posicione o cursor sobre o arquivo developers.json no Apigee Explorer e clique em .
  
  O assistente Criar desenvolvedor será aberto.
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"
  }
]
```
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 .
  
  O assistente "Criar aplicativo de desenvolvedor" é aberto.
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"
  }
]
```
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 .

Observação: se várioscontêineres do Apigee Emulator estiverem em execução, será solicitado que você selecione o contêiner em que você quer implantar o ambiente.

Os recursos de teste ativos aparecem na seção de emuladores da Apigee, como mostrado na figura a seguir.
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.
Copie o valor consumerKey (sem as aspas) do produto da API myproduct.
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 (NEXT) Etapa 5: alterar o endpoint de destino 6 7 8