“Preciso de API ou o iCal resolve?” é uma pergunta comum, e a resposta honesta é: depende de com quem você quer conversar. Para falar com Airbnb e Booking, o iCal é o caminho que as plataformas liberam a qualquer anfitrião. Para falar com o seu próprio site, a API de parceiro do ReservasHub é a ferramenta certa. São problemas diferentes, e os dois convivem.
Este artigo coloca as duas opções lado a lado, mostra o que cada uma entrega e como decidir. Para o pano de fundo sobre por que as plataformas não liberam API, leia Airbnb e Booking não liberam API.
O que é cada coisa
iCal é um formato de calendário baseado em um link. Cada plataforma gera um endereço com as datas ocupadas de um anúncio, e outro sistema o lê periodicamente. É o acesso que o Airbnb e o Booking oferecem a qualquer anfitrião.
A API de parceiro do ReservasHub é uma interface de programação, servidor para servidor, que permite ao seu site ou sistema consultar disponibilidade, cotação e unidades, e, no add-on, criar reservas e receber webhooks. Ela não conecta o ReservasHub às plataformas; conecta o ReservasHub ao seu código.
O que o iCal faz bem
- Sincroniza com as OTAs. O ReservasHub lê e publica calendários por iCal com Airbnb, Booking, VRBO e Expedia, e avisa quando duas reservas colidem na mesma unidade.
- É simples. Cola-se um link por plataforma, sem programar nada.
- Funciona em qualquer plano, sem custo extra.
- Evita o overbooking na maioria dos cenários, desde que o intervalo de atualização seja curto.
O ReservasHub busca as atualizações a cada 10 minutos. Do lado das plataformas, a frequência de atualização é delas e varia, como explica o texto sobre por que a sincronização iCal falha.
Limites do iCal
- Atraso. A sincronização acontece em ciclos, e não instantaneamente.
- Dados limitados. O feed carrega, basicamente, datas ocupadas e identificadores. Dados detalhados do hóspede não vêm por ali, e é por isso que existem formulários próprios para coletar e-mail, telefone e CPF.
- Só leitura de calendário. Não cria reserva no seu sistema a partir de um site seu.
O que a API faz bem
- Mostra disponibilidade e preço no seu site. A leitura é grátis: unidades, datas ocupadas e cotação calculada pelo servidor, com a mesma regra da página pública.
- Cria reservas direto do seu site (add-on), com
Idempotency-Keypara evitar duplicidade. - Avisa por webhook quando algo muda, com assinatura HMAC-SHA256 para você conferir a origem.
- Tem sandbox para testar com segurança.
Limites da API
- Não fala com Airbnb e Booking. A API do ReservasHub é a sua porta de entrada; a sincronização com as plataformas continua sendo por iCal.
- Não move dinheiro. O pagamento fica fora da API.
- Pede um desenvolvedor. É integração de código, com credenciais OAuth2, allowlist de IP e verificação de assinatura.
- Reservas que entram por iCal ainda não geram webhook. Para essas, a leitura de reservas serve como reconciliação.
Tabela de decisão
| Situação | O que usar |
|---|---|
| Sincronizar Airbnb e Booking com um calendário único | iCal |
| Evitar overbooking entre plataformas | iCal (calendário unificado) |
| Mostrar datas livres e preço no seu site | API (leitura grátis) |
| Receber pedido de reserva do seu site no calendário | API (escrita, add-on de R$ 39 por mês por conta) |
| Ser avisado quando uma reserva é criada ou cancelada | API (webhooks, no add-on) |
| Receber Pix e cartão do hóspede que reserva pela página da unidade | Pagamento direto (add-on separado), sem programar |
| Não tem site próprio e não quer programar | iCal e a página da unidade do ReservasHub |
Os dois funcionando juntos
Um desenho comum, para quem tem site próprio:
- Airbnb e Booking entram no calendário pelo iCal.
- O seu site consulta, pela API, as datas ocupadas (que já incluem as reservas vindas do iCal) e a cotação.
- Quando alguém reserva pelo site, a API cria a reserva, e ela passa a bloquear as datas no calendário unificado, que o iCal publica de volta para as plataformas.
- Um webhook avisa o seu sistema do que mudou, e uma leitura periódica confere o que ficou de fora.
O resultado é um calendário só, com três origens: duas plataformas e o seu canal.
Você precisa mesmo da API?
Muitos anfitriões não precisam. Se o seu volume vem das plataformas e a página da unidade do ReservasHub atende o hóspede recorrente, o iCal e a página própria já fecham o ciclo, sem programação. A API faz sentido quando:
- você já tem um site e quer que ele mostre o que está livre;
- o seu sistema precisa criar reservas ou reagir a elas;
- você atende como gestora e quer integrar com outra ferramenta sua.
Perguntas frequentes
O iCal é tempo real? Não. É sincronização em ciclos, e o intervalo depende de cada plataforma.
A API do ReservasHub conecta com a API do Airbnb? Não. As plataformas não abrem API de reservas a qualquer anfitrião, e o iCal é o acesso que elas liberam.
A leitura da API tem custo? Não. Disponibilidade, cotação e unidades são grátis em qualquer plano. Escrita de reservas e webhooks fazem parte do add-on de R$ 39 por mês, por conta.
Preciso migrar do iCal para a API? Não. Elas servem a propósitos diferentes e se complementam.
Quem decide o preço mostrado no meu site? O servidor, a partir da sua tabela de preços. O seu site não informa nem altera o valor.
O ReservasHub sincroniza Airbnb, Booking, VRBO e Expedia por iCal, consolida o financeiro por canal e oferece a API para quem quer um canal próprio.
→ Teste 3 meses grátis, sem cartão, em reservashub.com.br