Começar a usar a Rapid API

Começar a usar Rapid API é simples. Consiga uma chave de API e um segredo compartilhado, configure a autenticação da Rapid e comece a testar.

1. Torne-se parceiro

Para integrar com Rapid API, você precisa se candidatar para se tornar um parceiro se ainda não for um.

2. Leia os requisitos de lançamento aplicáveis ao seu site

Revise os requisitos de lançamento para decidir quais vão exigir o desenvolvimento de uma interface de usuário front-end e considere isso no planejamento do projeto.

• B2B somente acomodação
• B2C somente acomodação

• Vrbo

3. Prepare o seu ambiente

Revise estes recursos para preparar o seu ambiente para usar a Rapid.

• Como funciona
• Tratamento de solicitações de reserva
• Criação de políticas de cancelamento

4. Consiga as credenciais e configure a autenticação da Rapid

Após se tornar um parceiro e ter sua integração com Rapid API aprovada, você precisará obter sua chave de API. Para isso, faça login no portal da EPS e clique em Conectividade na barra de menu à esquerda. Depois, selecione a chave de API entre as opções. O portal exibirá os detalhes da sua chave de API atual.

A chave da API é uma das duas credenciais essenciais para a autenticação de assinatura. Você também vai precisar do seu segredo compartilhado, que pode ser acessado no portal da EPS e navegando até a página de chaves de API. A chave de API vai estar em modo de desenvolvimento restrito até que você receba aprovação para lançamento em um ambiente de produção, após a análise do site.

Para fazer uma solicitação ao nosso serviço de API, você vai usar o cabeçalho da autorização de HTTP para transmitir a sua chave de API e um hash de assinatura SHA-512 com cada solicitação. O hash SHA-512 é formado pelo seu segredo compartilhado, sua chave de API e um carimbo de data e hora UNIX atual. Os cabeçalhos de autorização para Rapid API sempre usam o seguinte formato:

Authorization: EAN APIKey=yourAPIKey,Signature=sha512Hash,timestamp=yourUNIXTimestamp

Veja todos os detalhes em nossa página de autenticação de assinatura. Você pode usar a nossa ferramenta de gerar assinatura para criar o valor de hash SHA-512 e testar a sua integração.

5. Comece a testar as suas solicitações

Após receber suas credenciais e configurar a autenticação, você poderá começar a fazer solicitações ao nosso endpoint de testehttps://test.ean.com/. No entanto, qualquer solicitação enviada para https://test.ean.com/ não vai resultar em reservas reais em propriedades nem cobranças no cartão de crédito. É possível escolher entre os nossos cabeçalhos de teste documentados para que a API de reservas controle o tipo de resposta que você deseja ver. Se você omitir um cabeçalho de teste de qualquer solicitação relacionada a reservas, o servidor de testes vai adicionar um de maneira automática.

Importante: Para garantir que oferecemos um serviço estável e sustentável, são aplicados limites de taxa. O sistema monitora o tráfego anormal de API e toma medidas para se proteger de maneira automática. Antes de fazer qualquer alteração planejada no comportamento de chamar a API ou realizar testes de desempenho com acesso à API, revise os seus planos com o seu consultor da Rapid.

Especificar a sua versão de API

Use o valor servers.url na especificação OpenAPI para construir o URL. test.ean.com é para validação da sua integração e api.ean.com é o ponto de extremidade de produção. Preserve o protocolo e o caminho ao alternar entre pontos de extremidade.

https://test.ean.com/v3/itineraries?… https://api.ean.com/v3/properties/22135/payment-options?token=U1dFC0JHTW

O valor servers.url é encontrado na parte superior dos nossos arquivos da especificação OpenAPI para download e sempre corresponde ao número da versão do serviço de API fornecido.

Exemplo: especificação OpenAPI

openapi: 3.0.1
info:
  title: Rapid
  description: EPS Rapid V3
  version: v3
servers:
  - url: https://test.ean.com/v3

6. Solicite uma avaliação do site

Quando você achar que a sua integração está pronta e tiver confirmado que ela atende aos requisitos de lançamento aplicáveis, solicite ao gerente de desenvolvimento de negócios uma avaliação do site. Quando você receber a aprovação, o gerente vai ativar a sua chave de API para uso de produção. Basta alterar os endpoints de solicitação de https://test.ean.com/para https://api.ean.come continuar fazendo solicitações; nenhuma alteração adicional no código é necessária.