Autenticación

Método

La Partners API usa autenticación por dos headers en cada request protegido:

Header	Descripción
`X-API-KEY`	Identificador público del partner
`X-API-SECRET`	Secreto del partner (no compartir)

Nunca expongas el API Secret en frontend, repositorios públicos ni logs. Úsalo solo desde tu backend.

Endpoints públicos vs protegidos

Endpoint	Auth requerida
`GET /health`	No
`GET /me`	Sí
`GET /health/saas`	Sí
`GET /countries`	Sí
`GET /zones`	Sí
`GET /categories`	Sí
`GET /tours`	Sí + permiso `tours:read`
`POST /reservations`	Sí + permiso `reservations:write`
`GET /reservations/{id}`	Sí + permiso `reservations:write`
`POST /reservations/confirm`	Sí + permiso `reservations:write`
`POST /reservations/cancel`	Sí + permiso `reservations:write`

Validar credenciales

Llama a GET /me después de configurar los headers. Una respuesta 200 confirma que las credenciales son válidas y muestra los permisos asignados.

curl -s "https://api-sandbox.vulcanopro.com/api/v1/me" \
  -H "X-API-KEY: TU_API_KEY" \
  -H "X-API-SECRET: TU_API_SECRET"

Respuesta esperada (ejemplo):

{
  "status": "ok",
  "data": {
    "id": 1,
    "name": "Partner_1",
    "apiKey": "vp_...",
    "status": "active",
    "rateLimitPerMinute": 60,
    "permissions": ["tours:read", "reservations:write"],
    "createdAt": "2026-06-23T00:00:00.000Z",
    "updatedAt": "2026-06-23T00:00:00.000Z"
  },
  "timestamp": "2026-07-02T12:00:00.000Z"
}

Sin reservations:write obtendrás 403 Missing required permission: reservations:write. Sin canal Vulcano vinculado, 403 Partner is not linked to a Vulcano sale channel.

Ejemplo en JavaScript

const baseUrl = 'https://api-sandbox.vulcanopro.com/api/v1';

const response = await fetch(`${baseUrl}/zones?countryId=43`, {
  headers: {
    'X-API-KEY': process.env.VULCANO_API_KEY,
    'X-API-SECRET': process.env.VULCANO_API_SECRET,
    Accept: 'application/json',
  },
});

const body = await response.json();

Errores de autenticación

HTTP	Causa
`401`	API Key o Secret incorrectos, o headers ausentes
`403`	Partner inactivo o sin permiso para el recurso

Ver Errores comunes para más detalle.

Playground

En la pestaña Referencia API, usa el botón de autenticación para ingresar X-API-KEY y X-API-SECRET y probar endpoints desde el navegador.

Introducción

Referencias

Tours

Reservas

Soporte

Autenticación

Método

Endpoints públicos vs protegidos

Validar credenciales

Ejemplo en JavaScript

Errores de autenticación

Playground

​Método

​Endpoints públicos vs protegidos

​Validar credenciales

​Ejemplo en JavaScript

​Errores de autenticación

​Playground

Método

Endpoints públicos vs protegidos

Validar credenciales

Ejemplo en JavaScript

Errores de autenticación

Playground