

# Habilitar o botão Experimente para um endpoint REST do produto do API Gateway em seu portal
<a name="apigateway-portals-try-it"></a>

Use o botão Experimente para permitir que um consumidor de API invoque o endpoint do seu produto por meio do seu portal. Quando um consumidor de API usa o botão Experimente, ele insere os parâmetros de solicitação do método e invoca o endpoint do produto. Depois, o API Gateway invoca sua API pela Internet pública e exibe a resposta na janela Experimente. Você pode usar uma página de produto personalizada para fornecer informações adicionais sobre os parâmetros necessários para acessar sua API.

O API Gateway utiliza os seguintes limites para proteger suas APIs:
+ O API Gateway permite apenas três solicitações por segundo para sua API.
+ O API Gateway utiliza um tempo limite integrado de 29 mil ms. Sua API real pode ter um limite de tempo maior, mas o API Gateway não aplica esse tempo limite quando um cliente utiliza o botão Experimente.
+ O API Gateway limita a carga útil de resposta a 6 MB.

## Considerações
<a name="apigateway-portals-try-it-considerations"></a>

As seguintes considerações podem afetar a maneira como você realiza um teste:
+ O botão Experimente não é aceito quando você visualiza um portal.
+ O botão Experimente não é aceito por APIs REST com os seguintes recursos:
  + APIs privadas
  + APIs que usam TLS mútuo.
  + APIs que usam certificados SSL privados ou autoassinados.

  Como proprietário do portal, você é responsável por se comunicar com seus consumidores de API. Esse é o motivo pelo qual o botão Experimente não existe para nenhuma API REST que não seja aceita. O API Gateway não explica isso para você.

## Habilitar o botão Experimente para um endpoint REST do produto
<a name="apigateway-portals-try-it-procedure"></a>

O procedimento a seguir mostra como ativar o botão Experimente para um endpoint do produto.

Para saber como utilizar o botão Experimente em um portal, consulte [Usar um portal do API Gateway](apigateway-portals-use-portal.md).

**Habilitar o botão Experimente para um endpoint REST do produto**

1. No painel de navegação principal, selecione **Produtos do portal**.

1. Escolha um produto.

1. Na guia **Documentação**, em **Páginas de referência de API**, escolha o nome de um endpoint REST do produto, como **/dogs - GET**.

1. Selecione **Editar página**.

1. Para permitir que os clientes invoquem sua API no portal, selecione **Recurso Experimente**.

1. Escolha **Salvar alterações**.

1. Você precisa publicar novamente todos os portais que usem o produto em questão para as alterações serem implementadas.