Saltar al contenido principal

Guía de Inicio Rápido

Comienza a usar la API de Partners de LosCenotes en minutos.

Requisitos Previos​

Antes de empezar, asegúrate de tener:

  • Una cuenta de Partner de LosCenotes
  • Conocimientos básicos de APIs REST
  • Un entorno de desarrollo (Node.js, Python, PHP, etc.)

Paso 1: Obtén tus Claves API​

  1. Inicia sesión en el Portal de Partners
  2. Navega a Configuración de API
  3. Genera tus claves API de sandbox
# Clave de Sandbox (para pruebas)
sk_test_1234567890abcdef...

# Clave de Producción (cuando esté lista)
pk_live_0987654321fedcba...
consejo

¡Siempre comienza con claves de sandbox para desarrollo y pruebas!

Paso 2: Instala un SDK (Opcional)​

Elige tu lenguaje preferido:

TypeScript/JavaScript​

npm install @loscenotes/partner-sdk

Python​

pip install loscenotes-partner

PHP​

composer require loscenotes/partner-sdk

Paso 3: Realiza tu Primera Llamada API​

Aquí tienes un ejemplo simple para listar cenotes disponibles:

Usando cURL​

curl -X GET https://service-gateway.loscenotes.com/v1/cenotes \
  -H "Authorization: Bearer sk_test_your_api_key" \
  -H "Content-Type: application/json"

Usando SDK de TypeScript​

import { LosCenotesClient } from "@loscenotes/partner-sdk";

const client = new LosCenotesClient({
  apiKey: "sk_test_your_api_key",
  environment: "sandbox",
});

const cenotes = await client.cenotes.list({
  limit: 10,
  isActive: true,
});

console.log(cenotes.data);

Usando SDK de Python​

from loscenotes import LosCenotesClient

client = LosCenotesClient(
    api_key='sk_test_your_api_key',
    environment='sandbox'
)

cenotes = client.cenotes.list(
    limit=10,
    is_active=True
)

print(cenotes.data)

Paso 4: Maneja la Respuesta​

Todas las respuestas de la API siguen esta estructura:

{
  "success": true,
  "message": "cenotes.list_retrieved_successfully",
  "data": [
    {
      "id": "c3n0t3-1234-5678-90ab",
      "name": "Cenote Dos Ojos",
      "location": {
        "latitude": 20.3274,
        "longitude": -87.3821
      },
      "pricing": {
        "adult": 350,
        "child": 200,
        "currency": "MXN"
      },
      "availability": {
        "monday": true,
        "tuesday": true
        // ...
      }
    }
  ],
  "pagination": {
    "total": 45,
    "perPage": 10,
    "currentPage": 1,
    "lastPage": 5
  },
  "_sandbox": true
}

Paso 5: Prueba Eventos Webhook​

Configura un endpoint webhook para recibir notificaciones en tiempo real:

app.post("/webhooks/loscenotes", (req, res) => {
  const signature = req.headers["x-loscenotes-signature"];

  // Verifica la firma del webhook
  if (!verifyWebhookSignature(req.body, signature)) {
    return res.status(401).send("Invalid signature");
  }

  // Procesa el evento
  const event = req.body;

  switch (event.type) {
    case "reservation.created":
      // Maneja nueva reservación
      break;
    case "reservation.confirmed":
      // Maneja confirmación
      break;
    case "reservation.cancelled":
      // Maneja cancelación
      break;
  }

  res.status(200).json({ received: true });
});

¿Qué Sigue?​

¿Necesitas Ayuda?​