Brancher d’autres outils

Les routes de l’API (aide-mémoire)

Lister types, créneaux, rendez-vous, séances et contacts ; réserver, annuler, inscrire.

À quoi ça sert

Écrire une intégration sur mesure.

Avant de commencer

Une clé d’API (Créer et gérer des clés d’API). Toutes les réponses sont en JSON.

Pas à pas

GET api.php?r=types : vos types actifs.
GET api.php?r=slots&type=<slug>&date=AAAA-MM-JJ[&tz=Fuseau] : créneaux libres.
GET api.php?r=bookings[&status=][&from=][&to=] et GET ?r=booking&id= : rendez-vous.
POST ?r=book (type, start ISO 8601, nom, email, tel, tz, answers[]) : réserver ; POST ?r=cancel (id, message) : annuler.
GET ?r=events, GET ?r=registrations&event=<slug>, POST ?r=register, POST ?r=attendance (event, email, attended) : séances.
GET ?r=contacts[&subscribed=1][&q=] : clients (avec unsubscribe_url).
GET ?r=hooks, POST ?r=hooks (url, events[]), DELETE ?r=hook&id= : webhooks. GET ?r=usage : forfait et quotas.

Résultat attendu

Codes de retour utiles : 201 réservation créée (avec payment_url si un paiement est requis), 400 champs manquants, 409 créneau indisponible ou paiement non configuré, 402 quota de réservations atteint, 429 trop de requêtes.

Astuces

Exemple : curl -H "Authorization: Bearer rk_…" "https://votre-rendezvix/api.php?r=bookings".
La route provision sert aux autres outils de l’écosystème avec une clé de serveur : elle n’est pas destinée aux clients.

Problèmes fréquents

409 « Créneau indisponible. »: Le créneau n’est plus libre dans le fuseau demandé.
402 quota_exceeded: La limite mensuelle de réservations du forfait est atteinte.