Desarrolladores

API pública v1 para desarrolladores

Integra tu sistema con Pranarp Club: consulta espacios y disponibilidad, crea y modifica reservas, sincroniza jugadores y recibe eventos por webhook.

Guías

Cada guía es corta y trae ejemplos que puedes ejecutar.

• Primeros pasos

  Activa las integraciones, crea una credencial y haz tu primera llamada a la API de Pranarp Club.

• Autenticación

  Tokens Bearer pck_live_, permisos (abilities), espacios permitidos, caducidad y errores de autenticación.

• Espacios, disponibilidad y presupuesto

  Consulta los espacios del club, los huecos libres y el precio de un uso antes de reservar.

• Idempotencia

  Reintentos seguros con la cabecera Idempotency-Key: duración, comportamiento y conflictos.

• Paginación

  Paginación por cursor: limit, cursor y meta.next_cursor, con un ejemplo de bucle completo.

• Fechas, zonas horarias e importes

  ISO 8601 con el desfase horario del club, horas sin offset e importes en céntimos con moneda.

• Errores

  Formato de error, todos los códigos estables, su estado HTTP y qué hacer en cada caso.

• Webhooks

  Eventos de reserva, formato del payload, verificación de firma, reintentos y desactivación.

• Límites de ritmo

  120 peticiones por minuto por credencial, cabeceras X-RateLimit y cómo reintentar tras un 429.

• Entorno de pruebas

  Cómo pedir un club de pruebas con las integraciones activadas.

• Cambios y versiones

  Historial de cambios de la API v1 y política de versiones.

• Referencia de la API

  Todas las operaciones, parámetros y respuestas, con un cliente para probarlas. Generada a partir de la especificación OpenAPI.