FR
Se connecter Réserver une démo
Développeurs

Une API REST conçue pour des données multi-locataires

Vingt-trois points de terminaison versionnés sous /api/v1. Authentification Bearer, permissions limitées, quotas par jeton et journal d’audit à chaque appel.

Authentification
# Générez un jeton dans Tableau de bord → Intégrations.
# Le secret n’est affiché qu’une fois et stocké sous forme de hachage SHA-256.

curl https://kourtiva.com/api/v1/me \
  -H "Authorization: Bearer $KOURTIVA_TOKEN"

# 401 si le jeton est invalide, expiré ou révoqué.
# 403 si le jeton n’a pas la permission requise.
# 429 dès que la limite de requêtes est dépassée.
api.kourtiva.com GET/v1/courts/availability Authorization: Bearer kv_live_•••• 200OK · 34ms { "venue": "vn_8832a", "courts": [ { "id": "crt_01", "sport": "padel", "free": ["19:00", "21:00"] }, { "id": "crt_02", "sport": "tennis", "free": ["18:00"] } ] }

Une sécurité qui n’est pas optionnelle

  • Secrets stockés hachés — une fuite de base ne donne aucun jeton exploitable
  • HTTPS imposé ; le HTTP simple est rejeté et non redirigé
  • Des permissions par jeton : une intégration de reporting ne peut pas écrire
  • Dates d’expiration optionnelles et révocation immédiate
  • Locataire résolu côté serveur — aucun identifiant de complexe n’est accepté d’un client
  • Méthode, chemin, statut, durée et jeton enregistrés pour chaque requête
Ressources

Ce que vous pouvez lire et écrire

Réservations

Listez, inspectez et filtrez les réservations de vos terrains, y compris l’état d’arrivée.

Terrains et créneaux

Définitions des terrains et créneaux réservables, avec disponibilité par date.

Sports et installations

Les sports que vous proposez et les installations rattachées à chaque complexe.

Membres

Les joueurs inscrits dans votre complexe, avec leur historique de réservation.

Factures et paiements

Des enregistrements financiers rattachés aux réservations qui les ont générés.

Tournois

Compétitions, équipes inscrites et rencontres.

Visiteurs

Comptages de fréquentation et synthèses pour le reporting d’occupation.

Profil du complexe

Votre propre fiche complexe — le locataire auquel le jeton renvoie.

Versionnée, pour que vous planifiiez vos montées de version

Tout vit sous /api/v1. Les changements cassants sortent en nouvelle version plutôt que d’arriver sans prévenir dans celle que vous avez intégrée.

Demander l’accès à l’API
Disponibilité des terrains
GET /api/v1/courts/12/slots?date=2026-08-09

{
  "data": [
    { "starts_at": "08:00", "available": true  },
    { "starts_at": "09:00", "available": false },
    { "starts_at": "10:00", "available": true  }
  ]
}

Besoin d’un point de terminaison que nous n’avons pas ?

Dites-nous avec quoi vous intégrez et nous étudierons la question.

Réserver une démo Explorer les fonctionnalités
Réserver une démo privée