API de hotéis B2B para empresas de viagens

O que a API cobre

O fluxo de hotéis segue a ordem em que uma reserva realmente acontece: pesquisar um destino, consultar a disponibilidade em tempo real de um hotel, fazer o checkout da opção escolhida (o preço é revalidado com o fornecedor neste ponto), pagar, confirmar e, depois, listar, consultar ou cancelar reservas. Os preços devolvidos já incluem o markup configurado para a sua agência.

A mesma chave de API também funciona para transfers privados, incluindo o serviço de motorista por hora, e para aluguel de carros. Você integra um único esquema de autenticação, um único formato de erro e um único registro de uso para os três produtos.

BASE="https://api.trekko.co/core"
AUTH="Authorization: ApiKey trk_test_xxxxxxxx:your_secret_here"

# 1) Search for the city
curl -sS "${BASE}/accommodation/search?query=Barcelona" -H "${AUTH}"

# 2) Live availability (prices already include your markup)
curl -sS -X POST "${BASE}/accommodations/get_accommodation_availability" \
  -H "${AUTH}" -H "Content-Type: application/json" \
  -d '{
        "accommodation_id": 1376114,
        "start_date": "2027-04-12",
        "end_date": "2027-04-15",
        "guests": [ { "id": 1, "age": 34 }, { "id": 2, "age": 30 } ],
        "guests_room_distribution": [ { "guest_ids": [1, 2] } ],
        "nationality": "ES",
        "currency_code": "EUR"
      }'

Preparada para tráfego de produção

As APIs de reservas falham de formas caras: um timeout durante a confirmação pode gerar uma reserva duplicada. A chamada de confirmação aceita um cabeçalho Idempotency-Key, de modo que uma nova tentativa com a mesma chave devolve a resposta original em vez de reservar duas vezes.

Os limites de requisições são aplicados por chave de API, e não por endereço IP, e os limites de cada agência são independentes, então o tráfego de outro parceiro nunca limita o seu. Os erros compartilham um único formato, e os erros de autenticação seguem a separação habitual entre credenciais desconhecidas e credenciais válidas sem permissão.

Webhooks e rebooking automático

As reservas feitas pela API são elegíveis ao rebooking automático da Trekko: enquanto o cancelamento gratuito ainda está aberto, a reserva é verificada todos os dias em busca de uma tarifa menor para a mesma estadia. Quando ocorre um rebooking, sua reserva mantém o mesmo identificador estável, e o seu sistema recebe um webhook booking.rebooked assinado com o preço antigo, o novo e a economia.

Os webhooks são assinados com HMAC para que você verifique que vêm da Trekko, e a entrega é de pelo menos uma vez, com novas tentativas automáticas; cada evento traz um identificador para você deduplicar. Você também pode desativar o rebooking em qualquer reserva individual pela API.

Primeiro o sandbox, produção quando houver fundos

Cadastre-se no sandbox com seu e-mail, confirme o código que enviamos e você recebe credenciais de teste na hora. O sandbox executa o ciclo completo de reserva em um catálogo de teste fixo, nunca chama um fornecedor real e nunca movimenta dinheiro, e inclui um simulador de rebooking para você testar o fluxo de webhooks sob demanda.

Carregar a conta não exige uma integração de pagamento separada. Você carrega a sua conta Trekko até o depósito mínimo por recarga de cartão, transferência bancária ou uma linha de crédito combinada, solicita o acesso à produção e, depois da aprovação da equipe da Trekko, ativa a produção para receber sua chave live. Para passar do sandbox para a produção, troca-se a chave e a URL base, acrescenta-se a etapa de pagamento, envia-se a confirmação completa e tratam-se os erros que o sandbox não produz.

Um checklist de integração

Armazene o identificador estável da reserva devolvido na confirmação, e não o número de confirmação do fornecedor, que pode mudar após um rebooking. Envie um Idempotency-Key em toda confirmação. Verifique a assinatura de todo webhook antes de agir sobre ele e deduplique pelo identificador do evento. Mostre aos seus usuários o prazo de cancelamento devolvido com cada oferta.

Quem integra a API da Trekko

Agências de viagens online que adicionam hotéis aos próprios sites, operadoras que alimentam um motor de pacotes dinâmicos, ferramentas de reservas corporativas que precisam de hospedagem e transporte terrestre, e startups de viagens que querem inventário sem negociar contratos com fornecedores um a um.

Perguntas frequentes