Saltar al contenido principal

Documentación para partners de LosCenotes

Este sitio explica cómo llamar la API de partners: la URL, la credencial y qué devuelve cada ruta.

URL base de todos los ejemplos:

https://service-gateway.loscenotes.com/api

Los precios en las respuestas son enteros en centavos, salvo que la página diga otra cosa.

Elige una credencial​

Sistema de reservas externo — X-API-Key​

Envía X-API-Key: sk_live_... en /api/partner/*. No existe X-API-Secret.

Secuencia habitual: listar cenotes, listar paquetes de un cenote, leer disponibilidad, calcular precio, crear la reserva y cobrar por checkout.

Las claves sk_test_ se rechazan en /api/partner/* con 403 error.partner.sandbox_key_not_allowed_on_production_api. Úsalas solo en /api/partner-sandbox/* y /api/partner/webhooks/simulator/*.

Usuario del portal — JWT​

Portal, ajustes, usuarios, reportes y reservas del portal esperan Authorization: Bearer <jwt>.

Personal de LosCenotes — JWT de admin​

Aprobar organizaciones, regenerar claves y atender tickets usa un JWT de admin. Esas páginas son para operadores, no para la clave de producción de un integrador.

Empieza aquí​

Comportamiento que vas a encontrar​

  • Sandbox. Las rutas /api/partner-portal/sandbox/* (incluido reset) responden HTTP 200 con un cuerpo que explica la indisponibilidad cuando el almacenamiento sandbox no está provisionado. POST /api/partner-sandbox/generate-data responde 400 partners.sandbox_schema_not_available en ese caso. GET /api/partner-sandbox/statistics devuelve ceros. DELETE /api/partner-sandbox/cleanup termina bien con deletedRecords: 0. Reset solo existe en la ruta del portal.
  • Tiempo real. Conecta un cliente Socket.IO a /partner/ws. Autentica con el JWT del portal o con una API key sk_live_. Las claves sandbox se rechazan. El detalle está en Autenticación.
  • Métricas. GET /api/partner-portal/metrics es la serie de tráfico de tu API. Si no hay tráfico, la serie queda vacía.
  • Facturación. El billing del portal (usage, invoices, plan) existe y sigue parcial: los conteos de llamadas pueden ser reales; ancho de banda, uso de webhooks, catálogo de planes y liquidaciones como facturas no son un producto comercial completo.
  • Soporte. El usuario partner puede crear, listar, leer y responder sus tickets. El triaje de personal es /api/admin/partner-support-tickets con JWT de admin.
  • Webhooks. Guarda solo URLs HTTPS públicas. Hosts privados y de metadata se rechazan. La entrega no sigue redirecciones.
  • Invitaciones. POST /api/partners/users/invite crea una membresía pendiente y no envía correo (emailDelivery=pending_manual).
  • Comisión. El partner solo puede actualizar customRates[]. Cambiar la tasa de pago responde 403 error.partner.commission_rate_admin_only.

OpenAPI​

  • Referencia completa: /docs
  • Referencia filtrada para partners: /partner-docs

Actualizado el 2026-09-21 contra la API de partners en vivo.