Saltar al contenido
CA ES
Solicitar una demo

Desarrolladores

Cambios y versiones

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

Aquí se recogen los cambios de la API pública y la política que seguimos al modificarla.

v1.0.0: versión inicial

La primera versión pública de la API, disponible en /api/v1.

  • Autenticación con tokens Bearer pck_live_… por club, con permisos (spaces:read, availability:read, bookings:read, bookings:write, bookings:write_all, players:read, players:write), restricción por espacios y caducidad opcional. GET /me.
  • Espacios: GET /spaces, GET /spaces/{id}.
  • Disponibilidad y presupuesto: GET /availability (hasta 14 días) y GET /quote.
  • Reservas: GET /bookings, GET /bookings/{id}, POST /bookings (con Idempotency-Key), PATCH /bookings/{id} y DELETE /bookings/{id} (cancelación).
  • Jugadores sincronizados por external_ref: GET, PUT y DELETE /players/{external_ref}.
  • Webhooks firmados con HMAC-SHA256 para booking.created, booking.updated y booking.cancelled, con reintentos y desactivación automática del endpoint.
  • Paginación por cursor, errores con códigos estables y límite de 120 peticiones por minuto por credencial.

Política de versiones

Esta API es nueva y, por ahora, todavía no tiene clientes en producción. Hasta que los tenga, los cambios se harán directamente sobre /api/v1, procurando no romper el contrato descrito en estas guías y en la referencia.

A partir del momento en que haya integraciones en uso, aplicaremos estas reglas:

  • Cambios compatibles, que no requieren que hagas nada: nuevos endpoints, nuevos campos opcionales en peticiones, nuevos campos en respuestas, nuevos códigos de error o nuevos tipos de evento de webhook. Tu cliente debe ignorar los campos y eventos que no conozca.
  • Cambios incompatibles (quitar o renombrar un campo, cambiar un tipo o un significado, endurecer una validación): llegarán en una versión nueva (/api/v2) y mantendremos la anterior durante un periodo de transición que anunciaremos con antelación.
  • Los códigos de error estables, los nombres de los permisos y el formato del payload de los webhooks forman parte del contrato.

La especificación OpenAPI es la fuente de verdad del contrato, y este historial se actualizará con cada cambio.