Desenvolupadors

API pública v1 per a desenvolupadors

Integra el teu sistema amb Pranarp Club: consulta espais i disponibilitat, crea i modifica reserves, sincronitza jugadors i rep esdeveniments per webhook.

Guies

Cada guia és curta i amb exemples que pots executar.

• Primers passos

  Activa les integracions, crea una credencial i fes la teva primera crida a l'API de Pranarp Club.

• Autenticació

  Tokens Bearer pck_live_, permisos (abilities), espais permesos, caducitat i errors d'autenticació.

• Espais, disponibilitat i pressupost

  Consulta els espais del club, les franges lliures i el preu d'un ús abans de reservar.

• Idempotència

  Reintents segurs amb la capçalera Idempotency-Key: durada, comportament i conflictes.

• Paginació

  Paginació per cursor: limit, cursor i meta.next_cursor, amb un exemple de bucle complet.

• Dates, zones horàries i imports

  ISO 8601 amb la diferència horària del club, hores sense offset i imports en cèntims amb moneda.

• Errors

  Format d'error, tots els codis estables, el seu estat HTTP i què fer en cada cas.

• Webhooks

  Esdeveniments de reserva, format del payload, verificació de signatura, reintents i desactivació.

• Límits de ritme

  120 peticions per minut per credencial, capçaleres X-RateLimit i com reintentar després d'un 429.

• Entorn de proves

  Com demanar un club de proves amb les integracions activades.

• Canvis i versions

  Historial de canvis de l'API v1 i política de versions.

• Referència de l'API

  Totes les operacions, paràmetres i respostes, amb un client per provar-les. Generada a partir de l'especificació OpenAPI.