API de reserva de hotéis grátis: o que o grátis entrega

É quinta à tarde e a demo é na segunda. Você achou uma API de reserva de hotéis grátis, se cadastrou com um e-mail e em cinco minutos tinha uma chave. O endpoint de busca devolve hotéis com fotos, estrelas e preço por noite. À noite a página de resultados já parece pronta. Na sexta você conecta a chamada de reserva e ela responde com um erro que você não consegue ler, porque aquilo em que você se cadastrou nunca foi capaz de fazer uma reserva.
Ninguém mentiu para você. Neste mercado, "grátis" está simplesmente colado em quatro produtos diferentes, e as páginas de cadastro não dizem qual deles está na sua mão.
Quatro coisas que "grátis" pode ser
Vale deixar esta tabela ao lado do teclado. Se o seu fornecedor faz diferente em alguma linha, discorde dela; isso também é uma descoberta útil.
| O que é a oferta grátis | O que você recebe | O que dá para construir | O que ela não faz |
|---|---|---|---|
| Conteúdo estático ou dados de diretório | Nomes de hotéis, endereços, fotos, comodidades, descrições | Um guia de hotéis, um mapa, uma página de destino | Mostrar um preço que você consiga honrar, ou um quarto realmente livre nas suas datas |
| Busca de afiliado com redirecionamento | Hotéis e preços, e um link para o checkout do próprio vendedor | Uma página de comparação que manda o tráfego embora | Manter do seu lado o cliente, o pagamento ou o registro da reserva |
| Sandbox com tarifas de teste | As chamadas completas de busca, preço, reserva e cancelamento, respondendo com inventário inventado | Uma integração funcionando e uma demo que se comporta como produção | Criar uma reserva que um hotel de verdade vai honrar |
| Tarifas ao vivo reserváveis | Quartos reais a preços net ou de venda reais, confirmados pelo fornecedor | Uma loja que recebe dinheiro por quartos | Ser grátis para quem assina o contrato |
As três primeiras são grátis porque quase não custam nada para o fornecedor distribuir. A quarta não é grátis porque alguém está carregando algo real.
Por que uma tarifa reservável sempre vem com contrato
Quando o seu cliente paga por um quarto, começa uma cadeia de obrigações. Um fornecedor tem o contrato com o hotel. Esse fornecedor prometeu ao hotel que o quarto será pago, e prometeu a você que o quarto existe. Se o hóspede cancela depois do prazo de cancelamento grátis, alguém deve uma noite ao hotel. Se a tarifa estava errada, alguém absorve a diferença. Se o cartão era roubado, alguém fica com o chargeback.
Tudo isso precisa cair numa parte com nome. Uma chave de API que qualquer pessoa gera com um e-mail não aguenta esse peso, e é por isso que o acesso reservável vem com um acordo, um esquema de liquidação e muitas vezes um limite de crédito. O preço que você paga pela chave "grátis" é que o fornecedor não precisa se importar com o que você faz com ela.
Nada disso é crítica aos planos grátis. Um feed de conteúdo é exatamente o certo para um guia de destino. Ele só é errado quando é confundido com aquilo de que você precisa para receber uma reserva.
Se você também está decidindo quantos fornecedores precisa por trás do que escolher, falamos disso em quantos fornecedores de API de hotel você precisa; a versão aérea da mesma confusão está em os três tipos de API de voos gratuita.
Há mais uma armadilha dentro da primeira linha. Conteúdo estático e tarifas ao vivo são dois feeds com vidas diferentes: a descrição de um hotel pode ficar no seu cache por semanas, a tarifa de hoje à noite não pode ficar lá por minutos. Um feed de conteúdo grátis que também mostra preço está citando um número que não vai bancar, e uma página feita em cima dele vai mostrar, toda feliz, um quarto que foi vendido ontem.
O que testar no sandbox antes de assinar qualquer contrato
O sandbox é a coisa grátis mais útil da tabela, então use sem dó. Um bom sandbox deixa você fazer cada passo de uma reserva real, com inventário falso mas no formato do de verdade.
- Busque com crianças e vários quartos. Ocupação é onde integrações simples quebram primeiro. Peça dois quartos com hóspedes diferentes e veja se a resposta os mantém separados.
- Confirme o preço antes de reservar. Muitos fornecedores esperam uma segunda chamada que confirme que a tarifa ainda vale. Se o sandbox não tem esse passo, pergunte se a produção tem.
- Reserve e depois leia o que voltou. Um quarto confirmado, um pedido pendente e um quarto sob consulta são três resultados diferentes, e a sua tela precisa dizer qual.
- Mude a tarifa entre a busca e a reserva. Tarifas mudam. Como é o erro, e o seu código consegue mostrar o novo preço ao cliente em vez de uma página em branco?
- Cancele dentro e fora da janela grátis. A política de cancelamento deveria vir como dados estruturados, com datas e valores, não como um parágrafo que você precisa interpretar.
- Falhe de propósito. Mande uma data errada, um código de hotel desconhecido, um token expirado. Conte quantos formatos diferentes de erro voltam.
Se o sandbox não consegue fazer os passos quatro e cinco, você tem uma API de conteúdo com uma URL com cara de reserva.
Quanto custa construir sobre o tipo errado
A versão cara desse erro não é a semana perdida. É a demo que dá certo.
Você mostra uma página de busca caprichada para quem decide, a pessoa aprova o orçamento, e só então o time descobre que a fonte por trás não consegue confirmar um quarto. O código não vai todo para o lixo, mas o fluxo de reserva, o pagamento, o tratamento de cancelamentos e a liquidação precisam ser construídos contra outro fornecedor, com outros nomes de campo. A página de busca que você mostrou vai então devolver outros hotéis, a outros preços, em outra ordem. Quem aprovou o orçamento vai perceber.
O hábito mais barato é fazer uma pergunta antes de escrever qualquer código: "Esta chave consegue criar uma reserva que um hotel vai honrar, e cancelá-la depois?" Se a resposta for qualquer coisa diferente de sim, você sabe qual das quatro está segurando.
Onde esta plataforma fica
Devemos ser tão claros sobre a nossa posição quanto fomos sobre as outras. A plataforma oferece APIs de voos e hotéis, e o acesso começa com uma conversa, não com uma chave self-service. É a quarta linha da tabela: por trás do inventário reservável existe alguém que precisa saber quem está pedindo. Se quiser ver como funciona para o seu projeto, comece pela página de APIs de viagem e conte para a gente o que você está construindo.
Conteúdo grátis, links de afiliado e sandboxes têm todos o seu lugar, e o certo depende do que você pretende vender. Escolha pelo que a chave consegue fazer no dia em que um cliente paga.