Développeurs

Une API REST claire pour les disponibilités et les réservations.

Lisez les disponibilités en direct et créez des réservations pour vos propres restaurants par programmation. Authentifiez-vous avec un seul jeton bearer, recevez du JSON, et reliez Tablevent au reste de votre stack.

Créer une clé d’API

Authentification

Chaque requête est authentifiée avec une clé d’API que vous générez vous-même. Les clés sont limitées à votre organisation et aux seuls restaurants que vous possédez. Envoyez votre clé comme jeton bearer dans l’en-tête Authorization — les clés ne s’affichent qu’une fois et ne sont stockées que sous forme de hachage, alors conservez la vôtre en lieu sûr.

1Connectez-vous et ouvrez API keys dans votre tableau de bord de gestion.
2Créez une clé — copiez le secret tvk_… affiché une seule fois.
3Envoyez-le comme jeton bearer à chaque requête.

Créer une clé d’API

En-tête Authorization

Authorization: Bearer tvk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

URL de base

Tous les points d’accès sont servis en HTTPS depuis un seul hôte. Les réponses sont en JSON ; les erreurs renvoient un corps JSON avec un champ error et un statut HTTP correspondant (401 non autorisé, 404 introuvable, 409 conflit, 429 limite de débit).

https://tablevent.com

Points d’accès

L’API publique est volontairement réduite et stable. Voici tout ce qui est disponible aujourd’hui — d’autres points d’accès arrivent.

GET/api/v1/availability

Renvoie les créneaux réservables de l’un de vos restaurants pour une date et un nombre de convives donnés. Paramètres : slug, date (AAAA-MM-JJ) et party.

Exemple de requête

curl "https://tablevent.com/api/v1/availability?slug=your-restaurant&date=2026-07-01&party=2" \
  -H "Authorization: Bearer tvk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

GET/api/v1/bookings

Liste les réservations les plus récentes de votre organisation (30 derniers jours) pour tous vos restaurants, les plus récentes en premier.

Exemple de requête

curl "https://tablevent.com/api/v1/bookings" \
  -H "Authorization: Bearer tvk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

POST/api/v1/bookings

Crée une réservation confirmée. Revérifie la disponibilité en direct sous verrou, pour ne jamais surréserver la dernière table. Renvoie l’identifiant de la nouvelle réservation.

Exemple de requête

curl -X POST "https://tablevent.com/api/v1/bookings" \
  -H "Authorization: Bearer tvk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "your-restaurant",
    "startsAt": "2026-07-01T19:00:00.000Z",
    "partySize": 2,
    "name": "Ada Lovelace",
    "email": "[email protected]"
  }'

Limites de débit

Les limites s’appliquent par organisation via un token bucket. Dépasser une limite renvoie un HTTP 429 — patientez puis réessayez.

Lectures (disponibilités, liste des réservations): Pic de 120, réapprovisionné à 2 requêtes/seconde
Écritures (créer une réservation): Pic de 30, réapprovisionné d’1 requête toutes les 2 secondes

Prêt à développer ?

Générez une clé dans votre tableau de bord et faites votre premier appel en quelques minutes. Besoin d’un point d’accès non listé ? Dites-nous ce que vous construisez.

Créer une clé d’API Nous contacter