Tratamento de solicitações de reserva
Evite erros e perdas tratando as solicitações de reserva adequadamente.
Visão geral
É importante projetar seu fluxo de trabalho de solicitação de reserva para ser tolerante a problemas de rede. Não interprete a falta de resposta como um indicador de uma reserva malsucedida. Se ocorrer um problema de infraestrutura após o envio de uma solicitação de reserva, mas antes do recebimento da resposta, a reserva do viajante ainda poderá ter sido cobrada e confirmada em nossos sistemas. Possíveis problemas de infraestrutura são:
- A conexão de rede foi perdida (nenhuma resposta retornada).
- O erro Server-side (código HTTP 500 ou 503) é retornado.
- Um gateway de rede inválido é observado (o código HTTP 502 é retornado).
- O tempo limite do gateway de rede é observado (o código HTTP 504 é retornado).
- Uma resposta não está seguindo a documentação Rapid API (um elemento-chave está faltando na mensagem).
- Uma resposta não está no formato JSON (por exemplo, uma mensagem de resposta está em HTML).
- Outras exceções, erros, comportamento desconhecido ou interrupções.
A solicitação de criação de reserva deve ser seguida por uma solicitação de recuperação de reserva que inclua:
- O valor original de
affiliate_reference_ide o e-mail usado na solicitação de criar reserva. OR - O valor de
itinerary_idelinks.retrieve.hrefretornado na resposta Criar reserva.
Observação: itinerários recém-criados podem, às vezes, ter um pequeno atraso entre o momento da criação e o momento em que o itinerário pode ser recuperado. Se você receber um erro ao tentar recuperar um itinerário criado com sucesso, ou se receber uma resposta com itinerary_ide creation_date_time, tente recuperar novamente por 30 minutos antes de following-up com nossos agentes de call center para obter mais suporte.
Procedimento recomendado
Sempre enviar affiliate_reference_id
Gere um affiliate_reference_idexclusivo para cada reserva. Se reenviar os mesmos detalhes da solicitação (por exemplo, devido a uma tentativa malsucedida), o mesmo affiliate_reference_iddeve ser usado. Isso evita reservas duplicadas acidentais. Ao enviar uma nova solicitação de criação de reserva, a API não vai responder até que a reserva seja confirmada ou recusada. A maioria das respostas é retornada em alguns segundos. No entanto, um pequeno número de reservas pode levar vários minutos para ser processado e para gerar uma resposta.
Monitore as reservas que não sejam resolvidas com rapidez
O Rapid API se conecta a sistemas externos para fazer reservas em real-time. Os sistemas dependentes incluem sistemas de reserva ou recepção de hotéis, processadores de cartão de crédito ou sistemas de detecção de fraudes. 98% das reservas podem concluir o processo em ~13 segundos. No entanto, caso não receba a resposta da reserva após 90 segundos, verifique o andamento da reserva com uma solicitação de recuperação, usando o mesmo affiliate_reference_id que foi enviado com a reserva. Se a reserva ainda estiver em andamento ou se a reserva tiver apresentado falha, você vai receber o erro 404 para itinerário não encontrado com a solicitação informada. Após receber essa mensagem, você deve tentar de novo a sua solicitação de reserva com o mesmo affiliate_reference_id. Se a reserva ainda estiver sendo concluída, você vai ver um erro 400 com uma mensagem informando que já existe um itinerário com o ID de referência do afiliado. Se esse erro for retornado, você vai poder recuperar a reserva de novo para ver se os detalhes da reserva estão prontos para serem visualizados.
A API de recuperação pode retornar erros ou uma resposta incompleta quando uma reserva está sendo processada. Tentar de novo a chamada de recuperação de reserva mais tarde vai recuperar 99,99% dos erros. Para cobrir um cenário de degradação, tente recuperar novamente por 30 minutos antes de entrar em contato conosco para obter mais suporte.
Disputas de reserva
Caso você encontre algum problema com a reserva devido a tempos limite, erros de código HTTP 50x ou outros problemas de infraestrutura, forneça os seguintes logs de transação para solução de problemas:
- A solicitação de reserva e a resposta (se disponível).
- A solicitação e a resposta da Recuperação de Reserva que foram enviadas 30 minutos após a última tentativa de reserva.
O log deve incluir os cabeçalhos HTTP da solicitação e da resposta. A mensagem de resposta tem um cabeçalho transaction-id que nos ajuda a identificar a transação da Rapid API.
Mais diretrizes de tratamento de erros.
Entre na sua conta de suporte Rapid API para visualizar um exemplo de interface de usuário, um pseudocódigo para lidar com reservas e um exemplos de plano de integração.