Resumen de la API Partner

Este resumen refleja la estructura real de controllers actualmente implementada en LosCenotes API.

URL base

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

Todas las rutas mostradas aquí ya incluyen el prefijo global /api.

Familias de endpoints partner

Familia	Base path	Auth	Endpoints
Public Partner API	/api/partner	X-API-Key excepto seed-test-data	7
Registro de partners	/api/partners	Público + throttling	2
Partner Portal	/api/partner-portal	JWT partner user	26
Admin Partners	/api/admin/partners	JWT admin	11
Settings	/api/partner-settings	JWT partner user	10
Users	/api/partners/users	JWT + permisos	9
Reports	/api/partner-reports	JWT partner user	7
Reservations	/api/partner-reservations	JWT partner user	6
Webhooks	/api/partners/webhooks	JWT + permisos	4
Sandbox	/api/partner-sandbox	Sandbox API key	3
Webhook Simulator	/api/partner/webhooks/simulator	Sandbox API key	4

Total actual de endpoints partner: 89

Arquitectura de respuesta

Los endpoints partner siguen el wrapper estándar de LosCenotes:

{
  "success": true,
  "message": "partners.portal.dashboard_retrieved",
  "data": {},
  "pagination": {
    "total": 25,
    "perPage": 15,
    "currentPage": 1,
    "lastPage": 2
  },
  "currency": {
    "code": "MXN",
    "symbol": "$"
  }
}

Notas

• pagination solo aparece en endpoints de lista
• currency solo aparece en endpoints con información monetaria
• algunos endpoints devuelven objetos operativos, otros listas o detalles
• la familia /api/partner está protegida en su mayoría por API key, con POST /api/partner/seed-test-data como excepción pública

Forma de errores

Las respuestas de error pueden incluir detalles de validación como estos:

{
  "success": false,
  "message": "validation.invalid_input",
  "statusCode": 400,
  "timestamp": "2026-03-10T18:00:00.000Z",
  "path": "/api/partner/reservations",
  "errors": {
    "messages": ["guestEmail must be an email"],
    "fields": {
      "guestEmail": ["guestEmail must be an email"]
    }
  }
}

Navegación por caso de uso

Integraciones externas

• Public Partner API quick reference
• Pricing
• Checkout
• Discounts and coupons

Onboarding de nuevos partners

• Partner registration
• Authentication
• Quickstart

Operación y portal

• Partner portal APIs
• Admin APIs
• Management features

APIs compartidas de plataforma

No todos los endpoints de integración viven en src/partners. Los partners también usan módulos compartidos como:

• /api/pricing/*
• /api/payment-methods*
• /api/checkout/*
• /api/public/discount-rules/*
• /api/coupons/*
• /api/cenotes/*

Esos endpoints se documentan en la sección de APIs compartidas de este sitio.

---

Verificado contra controllers el 2026-03-10.