$ API · OPENAPI 3.1

L'API MisterBookCloud

Une API HTTP JSON qui expose vos modules pour l'intégration à vos systèmes internes. Authentification OAuth 2.0, rate limiting configurable, documentation OpenAPI 3.1.

Endpoints principaux

GET /v1/modules — liste les modules actifs sur votre compte
GET /v1/modules/{id}/status — état de synchronisation d'un module
POST /v1/modules/{id}/tokens — rotation d'un jeton Misterbooking Cloud
GET /v1/audit — journal d'audit avec pagination cursor
GET /v1/invoices — factures mensuelles au format JSON ou PDF
POST /v1/webhooks — enregistrement d'un webhook signé HMAC-SHA256

Authentification

Chaque appel doit porter un jeton OAuth 2.0 dans l'en-tête Authorization: Bearer …. Les jetons se génèrent depuis votre espace client MisterBookCloud avec un périmètre limité (lecture, écriture) et une durée de validité configurable de 1 heure à 90 jours.

Rate limiting

Rate limit par défaut : 600 requêtes par minute et par jeton, extensible à 3 000 sur demande. Les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset sont retournés à chaque appel.

Documentation

La spécification OpenAPI 3.1 complète est publiée à https://api.misterbookcloud.org/openapi.json. Un explorateur Swagger UI est accessible depuis votre espace client. Les collections Postman et Insomnia sont téléchargeables.

SDK

TypeScript — npm install @misterbookcloud/sdk
Python — pip install misterbookcloud
PHP — via Composer misterbookcloud/sdk