Skip to main content

​
Sinopsis

La Vulcano Partners API es la API pública para partners externos. Permite consultar el catálogo de tours de Vulcano Pro y crear reservas (hold + confirm) usando credenciales propias. Esta documentación cubre el entorno sandbox para pruebas de integración. La URL de producción se habilitará cuando el partner esté listo para salir a prod.

​
Requisitos previos

Antes de integrar, asegúrate de tener:
  • API Key y API Secret de sandbox (entregados por el equipo Vulcano por canal seguro).
  • Cliente HTTP capaz de enviar headers personalizados (curl, Postman, fetch, axios, etc.).
  • Permiso tours:read para consultar tours.
  • Permiso reservations:write y canal Vulcano vinculado si vas a crear reservas.
  • Países y zonas no requieren permiso adicional (solo autenticación).

​
Flujo de integración recomendado

1

Verificar conectividad

Llama a GET /health para confirmar que la API responde.
2

Autenticarte

Envía X-API-KEY y X-API-SECRET en cada request protegido. Valida con GET /me y revisa permissions.
3

Obtener países

Consulta GET /countries para listar países disponibles.
4

Obtener zonas

Usa GET /zones?countryId=43 para listar zonas de Chile (u otro país).
5

Obtener categorías

Consulta GET /categories para listar categorías disponibles.
6

Listar tours

Consulta tours con los parámetros obligatorios: GET /tours?zone=5&date_from=2026-07-12&date_to=2026-07-16&passengers=5. Opcionalmente puedes filtrar por category.
7

Crear hold y confirmar

Con un tour_id, fecha y horario disponibles: POST /reservations → opcionalmente GET /reservations/{id} → POST /reservations/confirm. Ver Reservations.

​
Formato de respuesta

Todas las respuestas exitosas usan el mismo sobre:

​
IDs canónicos de Vulcano

Los parámetros countryId, zone, category y tour_id son IDs internos de Vulcano, no IDs del partner. Debes usarlos tal como los devuelve esta API. El booking expone además:
  • id — UUID público de la reservation (úsala en la API).
  • order_id — ID interno de la orden en Vulcano (solo referencia).
Usa la pestaña Referencia API para probar endpoints en el playground interactivo.

​
Próximos pasos

Países

Catálogo de países Vulcano.

Zonas

Catálogo de zonas Vulcano.

Categorías

Catálogo de categorías Vulcano.

Tours

Catálogo, tarifas y disponibilidad.

Reservations

Hold, confirmación y pasajeros.

Autenticación

Cómo enviar credenciales en cada request.