Introdução à Rapid

É fácil começar a usar a Rapid. Consiga uma chave de API e um segredo compartilhado, configure a autenticação da Rapid e comece a testar.

1. Torne-se parceiro

Para fazer a integração com a Rapid, você precisa fazer uma solicitação para se tornar parceiro, caso ainda não seja.

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 quarto
• B2C somente quarto

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

Depois de se tornar nosso parceiro e ter a integração com a Rapid aprovada, você vai precisar receber a 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. Os detalhes da sua chave de API atuais serão mostrados.

A chave de API é uma das duas credenciais de chave necessárias para o sistema de autenticação de assinatura do Rapid. 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 da Rapid sempre seguem este formato:

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

Veja os detalhes completos 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

Depois de receber as suas credenciais e configurar a autenticação da Rapid, você pode começar a enviar solicitações para o nosso ponto de extremidade de teste, https://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 um serviço estável e contínuo para todos os parceiros, são aplicados limites de taxa de tráfego. 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 trocar os pontos de extremidade da solicitação de https://test.ean.com/ para https://api.ean.com e continuar fazendo solicitações. Não são necessárias outras alterações no código.