Mi contexto

GET /api/v1/me

La llamada de arranque. Responde a cuatro preguntas a la vez:

• qué organización abre la clave — es todo el alcance de la clave, y ninguna petición puede cambiarlo;
• qué puede hacer allí el portador (owner, admin o member);
• las reglas de las que dependen todos los demás endpoints: zona horaria, moneda, margen, caducidad de las reservas provisionales;
• el plan: el límite, el uso actual y lo que queda para villas, reservas y clientes.

Autorización

Basta con ser miembro — un agente tiene que poder descubrir que no tiene permiso para escribir.

Parámetros

Ninguno.

Ejemplo

curl -H "x-api-key: $VILLASLOT_API_KEY" \
  "https://villaslot.app/api/v1/me"

Respuesta

• 200 OK — el contexto.

{
  "success": true,
  "data": {
    "organization": {
      "id": "a379bb76-…",
      "name": "TechCorp Solutions",
      "slug": "techcorp-solutions"
    },
    "key": {"userId": "8105d4bd-…", "organizationRole": "owner"},
    "settings": {
      "timezone": "Asia/Makassar",
      "currency": "IDR",
      "bufferMinutes": 30,
      "holdExpirationHours": 24,
      "configured": true
    },
    "plan": {
      "name": "free",
      "hasSubscription": true,
      "limits": {
        "properties": {"limit": 1, "usage": 4, "remaining": 0},
        "bookings": {"limit": 10, "usage": 7, "remaining": 3},
        "customers": {"limit": 15, "usage": 4, "remaining": 11}
      }
    }
  }
}

Qué rechaza

• 401 Unauthorized — clave ausente o no válida, o clave cuyo portador ha dejado la organización.
• 429 Too Many Requests — más de 120 peticiones en un minuto para esta clave.

Notas

• settings.configured: false significa que todavía no se ha elegido ninguna moneda. La creación de una reserva se rechazará mientras no haya una.
• plan.limits.*.remaining: 0 es una promesa, no una indicación: el servicio vuelve a comprobar el mismo veredicto antes de cualquier escritura, y la creación responderá 409.