API Plateforme

Intégrez TapGoMatch
dans votre application

Accédez en temps réel à tous les complexes sportifs partenaires. Consultez les disponibilités et créez des réservations pour vos utilisateurs.

Endpoints

120

req/min

REST

JSON / HTTPS

Authentification

Chaque requête doit inclure deux headers HTTP. Les clés sont transmises par email après approbation.

Headers requis

X-Api-Key-Id:  tapgo_platform_xxxxxxxxxxxxxxxxxxxx
X-Api-Secret:  tapgo_platform_sk_yyyyyyyyyyyyyyyy

Le secret ne s'affiche qu'une seule fois après création. Stockez-le dans un gestionnaire de secrets — jamais en clair dans votre code.

120 req/min

Rate limit

HTTPS

Requis

Scopes

Granulaires

Scopes disponibles

tenants:readLister les complexes

bookables:readLister les terrains

availability:readConsulter les disponibilités

bookings:createCréer des réservations

bookings:readConsulter les réservations

Endpoints

GET/api/platform/tenantstenants:read

Liste tous les complexes sportifs actifs avec leurs terrains.

cURL

curl https://tapgomatch.com/api/platform/tenants \
  -H "X-Api-Key-Id: tapgo_platform_xxx" \
  -H "X-Api-Secret: tapgo_platform_sk_yyy"

GET/api/platform/availabilityavailability:read

Créneaux disponibles. Sans tenant_id, retourne tous les complexes.

Paramètres

Nom	Type	Description
`date`	string	Date YYYY-MM-DD
`duration`	integer	Durée en minutes (30–480)
`tenant_id`	uuid	Filtrer par complexe
`category`	string	football, basketball, tennis

cURL

curl "https://tapgomatch.com/api/platform/availability?date=2026-08-01&duration=60" \
  -H "X-Api-Key-Id: tapgo_platform_xxx" \
  -H "X-Api-Secret: tapgo_platform_sk_yyy"

POST/api/platform/bookingsbookings:create

Crée une réservation pour un client sur n'importe quel complexe.

Paramètres

Nom	Type	Description
`bookable_id`	uuid	ID du terrain
`date`	string	Date de session (YYYY-MM-DD)
`start_time`	string	Heure de début (HH:mm)
`duration`	integer	Durée en minutes
`guest_name`	string	Nom du client
`guest_phone`	string	Téléphone du client

cURL

curl -X POST https://tapgomatch.com/api/platform/bookings \
  -H "X-Api-Key-Id: tapgo_platform_xxx" \
  -H "X-Api-Secret: tapgo_platform_sk_yyy" \
  -H "Content-Type: application/json" \
  -d '{"bookable_id":"uuid","date":"2026-08-01","start_time":"10:00","duration":60,"guest_name":"Mamadou Diallo","guest_phone":"+221771234567"}'

GET/api/platform/bookings/{id}bookings:read

Statut d'une réservation créée via l'API.

Paramètres

Nom	Type	Requis	Description
`id`	uuid		ID de la réservation

cURL

curl https://tapgomatch.com/api/platform/bookings/{id} \
  -H "X-Api-Key-Id: tapgo_platform_xxx" \
  -H "X-Api-Secret: tapgo_platform_sk_yyy"

Codes HTTP

200Succès

201Ressource créée

401Clé API invalide ou absente

403Scope insuffisant

409Créneau indisponible

422Données invalides

429Limite dépassée — 120 req/min

503API temporairement désactivée

Prêt à intégrer TapGoMatch ?

Réponse sous 48h ouvrées après soumission.

Intégrez TapGoMatch dans votre application

Authentification

Scopes disponibles

Endpoints

Codes HTTP

Prêt à intégrer TapGoMatch ?

Intégrez TapGoMatch
dans votre application