API de hoteles B2B para negocios de viajes

Qué cubre la API

El flujo de hotel sigue el orden en que ocurre una reserva real: buscar un destino, pedir disponibilidad en vivo de un hotel, pasar por checkout con la opción elegida (el precio se revalida con el proveedor en este punto), pagar, confirmar y, más adelante, listar, consultar o cancelar reservas. Los precios devueltos ya incluyen el markup configurado para tu agencia.

La misma clave de API sirve también para traslados privados, incluido el servicio de chófer por horas, y para alquiler de coches. Integras un esquema de autenticación, un formato de errores y un registro de uso para los tres productos.

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áfico de producción

Las API de reservas fallan de formas caras: un timeout durante la confirmación puede crear una reserva duplicada. La llamada de confirmación acepta una cabecera Idempotency-Key, de modo que un reintento con la misma clave devuelve la respuesta original en lugar de reservar dos veces.

Los límites de peticiones se aplican por clave de API y no por dirección IP, y los de cada agencia son independientes, así que el tráfico de otro socio nunca ralentiza el tuyo. Los errores comparten un mismo formato, y los errores de autenticación distinguen entre credenciales desconocidas y credenciales válidas sin permiso.

Webhooks y rebooking automático

Las reservas hechas por API son aptas para el rebooking automático de Trekko: mientras la cancelación gratuita sigue abierta, la reserva se revisa cada día en busca de una tarifa más baja para la misma estancia. Cuando se produce un rebooking, tu reserva conserva el mismo identificador estable y tu sistema recibe un webhook booking.rebooked firmado con el precio anterior, el nuevo y el ahorro.

Los webhooks se firman con HMAC para que puedas verificar que proceden de Trekko, y la entrega es al menos una vez con reintentos automáticos; cada evento lleva un identificador con el que puedes deduplicar. También puedes excluir del rebooking cualquier reserva concreta a través de la API.

Primero sandbox, producción cuando tengas fondos

Regístrate en el sandbox con tu email, confirma el código que te enviamos y recibes credenciales de prueba al momento. El sandbox ejecuta el ciclo completo de reserva sobre un catálogo de pruebas fijo, nunca llama a un proveedor real y nunca mueve dinero, e incluye un simulador de rebooking para probar el flujo de webhooks cuando quieras.

Pasar a producción no exige una integración de pago aparte. Fondeas tu cuenta de Trekko hasta el depósito mínimo con recarga por tarjeta, transferencia bancaria o una línea de crédito acordada, y activas producción para recibir tu clave real. El código escrito contra el sandbox funciona en producción cambiando la clave y la URL base.

Lista de comprobación para tu integración

Guarda el identificador de reserva estable devuelto en la confirmación, no el número de confirmación del proveedor, que puede cambiar tras un rebooking. Envía un Idempotency-Key en cada confirmación. Verifica la firma de cada webhook antes de actuar y deduplica por el identificador del evento. Muestra a tus usuarios la fecha límite de cancelación que llega con cada oferta.

Quién integra la API de Trekko

Agencias de viajes online que añaden hoteles a sus propias webs, touroperadores que alimentan un motor de paquetes dinámicos, herramientas de reserva corporativas que necesitan estancias y transporte terrestre, y start-ups de viajes que quieren inventario sin negociar contratos con proveedores uno a uno.

Preguntas frecuentes