Créez votre propre boutique de location sur l'API Be-Bookable
En résumé
- Votre développeur crée votre propre boutique en ligne ou parcours de réservation, dans votre propre design. Be-Bookable fournit les produits, les disponibilités, les prix et le paiement.
- Vos propres systèmes lisent vos commandes grâce à un jeton API, et les webhooks les informent lorsqu'une commande est passée, payée ou que son statut change.
- L'API est incluse dans chaque forfait Be-Bookable, sans frais supplémentaires. Votre développeur construit et teste sur une sandbox avec des paiements de test.
Pourquoi construire sur l'API Be-Bookable
Avec deux lignes de code, le Widget pour site web place une boutique de location prête à l'emploi sur votre site. Certaines entreprises de location veulent plus : un parcours de réservation dans leur propre design, ou des commandes qui arrivent directement dans leurs propres systèmes. Avec l'API, votre développeur construit exactement cela, et Be-Bookable continue de faire la partie difficile : disponibilités, prix, TVA, cautions et paiement.
Nous calculons, vous concevez
Disponibilités, prix, TVA, livraison, caution et paiement viennent de Be-Bookable. Votre vitrine affiche seulement les résultats, elle correspond donc toujours à votre stock et à vos prix.
Commandes dans vos propres systèmes
Un script, Zapier ou Make lit vos commandes avec un jeton API, informations client comprises. Les webhooks envoient un message signé quand une commande est passée, payée ou change de statut.
Construire et tester en toute sécurité
Votre développeur construit sur une sandbox avec des paiements de test, à côté d'une boutique d'exemple qui fonctionne. La version 1 ne fait qu'ajouter des choses, votre boutique continue donc de fonctionner quand l'API s'enrichit.
Comment créer votre propre boutique sur l'API
- Activez l'accès API. Dans l'application Be-Bookable, allez dans Integrations et ouvrez la carte API access. Ajoutez le domaine de votre propre boutique, par exemple
shop.example.com, et l'URL de retour après le paiement. Activez-le ensuite. - Construisez sur la sandbox. Votre développeur commence par le guide Créez votre propre boutique, accompagné d'une boutique d'exemple qui fonctionne. La sandbox sur
https://test.api.be-bookable.com/v1accepte les paiements de test et dispose d'une boutique de test, chaque étape peut donc être essayée sans vraies commandes. - Laissez Be-Bookable gérer la réservation. Votre vitrine affiche le catalogue, vérifie la disponibilité et demande le total à Be-Bookable. Elle crée ensuite la commande et envoie le client vers la page de paiement. Après le paiement, le client arrive sur votre URL de retour.
- Connectez vos propres systèmes. Ouvrez la carte Orders API & webhooks. Créez un jeton API pour chaque programme et ajoutez l'URL de votre webhook. Send test event montre aussitôt si votre serveur reçoit le message. Seul le propriétaire de la boutique peut le faire.
- Passez en production. Enregistrez le domaine de votre boutique en production, remplacez l'URL de base par
https://api.be-bookable.com/v1et passez une vraie commande sur tout le parcours.
Ce que couvre l'API
Les requêtes dans l'ordre où un client les utilise :
Accès, limites et webhooks
- Vitrine : Aucun jeton n'est requis. Votre boutique envoie ses requêtes depuis le navigateur, sur les domaines que vous avez enregistrés. La commande renvoyée par votre boutique ne contient aucune donnée personnelle de vos clients.
- API de commandes : un jeton API dans l'en-tête
Authorization, uniquement depuis votre serveur. Il lit les mêmes commandes que celles que vous voyez dans Gestion des commandes, avec les informations client. Une boutique peut avoir 10 jetons, et vous révoquez chacun séparément. - Webhooks : trois événements, signés avec HMAC-SHA256 :
order.created,order.paid,order.status_changed. Si votre serveur ne répond pas, nous réessayons après 1 minute, 5 minutes, 30 minutes, 2 heures et 12 heures. Chaque message est conservé dans le journal de livraison pendant 30 jours. - Limites : 120 lectures et 10 écritures par minute pour chaque adresse IP, et 600 requêtes par minute pour chaque jeton. Une réponse 429 indique dans Retry-After quand réessayer.
- Versions : la version 1 ne fait qu'ajouter des choses, comme de nouveaux champs ou endpoints. Chaque modification figure dans le journal des modifications de l'API.
Découvrez-le en action
Une vraie requête du guide : votre boutique demande le total d'un panier et Be-Bookable le calcule. Puis le message que votre serveur reçoit quand une commande est payée.
Foire aux questions
L'API est-elle payante ?
Non. L'API est incluse dans tous les forfaits Be-Bookable, voir Tarifs. Vous ne payez que votre propre développeur ou agence pour le travail effectué sur votre boutique.
Ai-je besoin d'un développeur ?
Oui. L'API s'adresse à quelqu'un qui écrit du code, comme votre propre développeur ou une agence web. Vous voulez une boutique de location sur votre site sans code ? Utilisez alors le widget de site web.
Quelle est la différence avec le widget du site web ?
Le widget de site web est une boutique de location prête à l'emploi que vous placez sur votre site avec deux lignes de code. Avec l'API, votre développeur crée la vitrine : le design et le parcours de réservation sont entièrement les vôtres. Derrière les deux se trouvent les mêmes produits, disponibilités, prix et commandes dans Be-Bookable.
Quelle est la différence avec l'assistant IA ?
L'assistant IA est fait pour vous : vous interrogez Claude ou ChatGPT sur votre boutique et vous lui faites modifier les prix, le stock ou les horaires d'ouverture, sans code. L'API est destinée au logiciel que crée votre développeur : une vitrine pour vos clients et des liens avec vos propres systèmes.
Peut-on faire des tests sans commandes réelles ?
Oui. La sandbox sur https://test.api.be-bookable.com/v1 accepte les paiements de test, et la boutique d'exemple y montre une commande complète. Pour les webhooks, « Send test event » dans l'application envoie un message de test à votre serveur, signé avec votre vrai secret.
Quels sont les webhooks disponibles ?
Trois : order.created quand une commande est passée, order.paid quand le paiement est confirmé et order.status_changed quand le statut d'une commande change. Chaque message est signé, votre serveur peut donc vérifier qu'il vient de Be-Bookable. Zapier et Make peuvent aussi les recevoir.
Y a-t-il des limites de requêtes ?
Oui. Pour chaque adresse IP : 120 lectures et 10 écritures par minute, avec un maximum de 10 commandes par minute. Pour chaque jeton API : 600 requêtes par minute. L’en-tête de chaque réponse indique le nombre de requêtes restantes.
Mon développeur peut-il consulter les données de mes clients ?
Uniquement avec un jeton API. Les requêtes de votre vitrine ne donnent jamais les données personnelles de vos clients. Un jeton API lit vos commandes avec les informations client, et seul le propriétaire de la boutique peut en créer un. Un jeton révoqué cesse aussitôt de fonctionner.
Où se trouve la documentation ?
Tout se trouve sur developers.be-bookable.com : le guide Créez votre propre boutique, la référence complète de chaque requête, la boutique d'exemple et le journal des modifications.
