API développeur

Commencez simplement, intégrez ensuite en profondeur.

Lancez-vous sur la page hébergée pour aller vite, intégrez le widget pour respecter le design de votre site, ou construisez un parcours entièrement sur mesure sur l'API REST publique, avec des clés à portée limitée, une réservation idempotente et une spécification OpenAPI 3.1 publiée.

Commencer Voir le widget de réservation

Idéal pour : les développeurs qui construisent une expérience de réservation sur mesure (votre interface, votre logique) au-dessus du même moteur que la page hébergée et le widget.

Choisissez votre intégration

3 façons

Page de réservation hébergée, sans code

Widget intégré, quelques lignes

API REST publique✓

Ce que ça résout

Trois façons de construire, un seul moteur de réservation.

Toutes les entreprises n'ont pas besoin du même niveau de contrôle, et vous ne devriez pas avoir à choisir d'emblée. La page hébergée vous met en ligne vite, le widget place la réservation dans le design de votre site, et l'API est là quand il vous faut une expérience entièrement sur mesure.

Les trois tournent sur le même moteur : le verrouillage des places, les paiements, les décharges et les confirmations se comportent à l'identique quel que soit votre choix. Commencez simplement et passez à l'API quand votre produit a besoin d'une logique sur mesure, sans migration entre les deux.

# Créer une réservation POST /v1/bookings Authorization: Bearer sk_... { "event_id": "evt_8KQ2", "seats": 2 } -> 201 Created { "id": "bkg_5X9", "status": "confirmed" }

Points de terminaison publics

L'API REST sur laquelle repose votre parcours de réservation.

/v1/events. Listez les séances réservables avec leurs détails et la disponibilité des places en direct.
/v1/bookings. Créez des réservations avec une clé d'idempotence pour qu'un nouvel essai ne double jamais la réservation.
/v1/giftcards. Recherchez et appliquez des cartes cadeaux dans le cadre d'une réservation.
/v1/promocodes. Validez un code promo avant le paiement, avec un accès public à débit limité.
/v1/customers. Travaillez avec les fiches clients rattachées par e-mail.
/v1/courses. Listez les formations en plusieurs séances, obtenez des devis et réservez une formation entière en un seul appel.
/v1/categories. Lisez vos catégories d'événements pour regrouper et filtrer ce que vous affichez.
/v1/tenant/config. Récupérez la configuration publique pour afficher correctement votre parcours de réservation.
/v1/referrals. Recherchez un code de parrainage pour que les clients parrainés reçoivent le bon crédit.
/v1/payments/paypal. Créez et capturez des commandes PayPal dans le cadre d'une réservation.
Spécification OpenAPI 3.1. Toute l'API est livrée sous forme de spécification OpenAPI 3.1 complète et téléchargeable, à partir de laquelle vous pouvez générer des clients typés, avec une référence interactive dans l'application et des exemples de requêtes et de réponses à copier-coller.

Clés et sécurité

Pensé pour la production dès la première requête.

Clés publiques et secrètes. Intégrez des clés publiques pk_ dans le navigateur et gardez les clés secrètes sk_ côté serveur pour un accès complet.
Portées sur les clés publiques. N'accordez à une clé de navigateur que l'accès nécessaire, comme parcourir les événements ou vérifier des soldes de cartes cadeaux, et rien de plus.
Vérification d'origine pour les clés publiques. Ajoutez des origines autorisées à une clé publique : les requêtes portant une origine de navigateur doivent correspondre, de sorte qu'une clé ne puisse pas être réutilisée depuis un autre site.
Expiration, révocation et modification. Donnez à une clé une date d'expiration facultative, révoquez-la instantanément, ou mettez à jour son nom, ses portées et ses origines à mesure que votre intégration évolue.
Secrets stockés hachés. La clé brute n'est affichée qu'une fois, à la création ; seule une empreinte est conservée, de sorte qu'une base de données divulguée n'expose jamais une clé utilisable.
Limites de débit. Les requêtes sont limitées en fréquence pour garder l'API stable sous la charge et face aux abus.
Clés d'idempotence à la réservation. Des nouveaux essais sûrs : une connexion interrompue ne se transforme jamais en réservation en double.
Le même moteur en dessous. Le verrouillage des places, les paiements, les décharges et les confirmations correspondent exactement à la page hébergée et au widget.

Comment ça marche

Du premier appel au parcours sur mesure en production.

Créez vos clés

Générez des clés publiques et secrètes, définissez des portées sur les clés publiques et ajoutez des origines autorisées pour que les requêtes du navigateur soient vérifiées.

Lisez le planning

Appelez /v1/events pour lister les séances réservables et la disponibilité des places, et validez les codes promo avant le paiement.

Créez des réservations

Envoyez une requête à /v1/bookings avec une clé d'idempotence. Les places se verrouillent pendant le paiement et le règlement est capturé.

Livrez votre expérience sur mesure

Construisez l'interface que vous voulez au-dessus de l'API, en vous appuyant sur les points de terminaison documentés et les exemples du SDK pour avancer vite.