Saltar al contenido principal

Guía de Inicio Rápido

Empieza a usar la superficie partner actual de LosCenotes.

Paso 1: Usa la URL base correcta​

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

Todos los ejemplos actuales usan el prefijo global /api.

Paso 2: Haz tu primera petición partner​

curl -X GET "https://service-gateway.loscenotes.com/api/partner/cenotes" \
  -H "X-API-Key: pk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -H "Accept-Language: es"

Paso 3: Entiende el wrapper de respuesta​

{
  "success": true,
  "message": "partners.cenotes.list_retrieved_successfully",
  "data": [],
  "pagination": {
    "total": 45,
    "perPage": 10,
    "currentPage": 1,
    "lastPage": 5
  },
  "meta": {
    "requestId": "req_123",
    "processingTime": 24,
    "version": "1.0.0",
    "cacheHit": false
  }
}

Paso 4: Calcula pricing​

curl -X POST "https://service-gateway.loscenotes.com/api/pricing/calculate-complete" \
  -H "Content-Type: application/json" \
  -d '{
    "itemType": "cenote",
    "itemId": "550e8400-e29b-41d4-a716-446655440000",
    "ageBreakdown": {
      "adult": 2,
      "child": 1
    }
  }'

Paso 5: Valida antes de reservar​

curl -X POST "https://service-gateway.loscenotes.com/api/public/reservations/validate" \
  -H "Content-Type: application/json" \
  -d '{
    "itemType": "cenote",
    "itemId": "550e8400-e29b-41d4-a716-446655440000",
    "date": "2026-04-20",
    "startTime": "09:00",
    "visitors": 3
  }'

Notas importantes​

  • las integraciones externas partner usan X-API-Key
  • el pricing de cara a API en booking flows se documenta generalmente en centavos, salvo que una página indique una excepción de metadata
  • para el comportamiento actual, usa las páginas de API reference por encima de ejemplos genéricos viejos