API REST · OpenAPI 3

L’API REST
EspaceRendezVous

Intégrez toute la prise de rendez-vous dans votre système d’information, vos fronts et votre CRM. Architecture headless : vous gardez la main sur l’expérience, nous fournissons la logique métier et les données.

availabilities · 200 OK
// Créneaux disponibles en temps réel
GET /availabilities?proName=galeries-lafayette
Authorization: Bearer eyJhbGciOi…
apiKey: rdv_live_8f2c…

200 OK
{
  "slots": [
    { "start": "2026-07-01T09:00", "with": "Camille D." },
    { "start": "2026-07-01T14:30", "with": "Yanis B." }
  ]
}
7
familles d’API
46
endpoints REST
55
objets de données
OpenAPI 3
REST · JSON
JWT
+ clé API
Pourquoi notre API

Pensée pour vos intégrations grands comptes

Couverture de bout en bout

Référentiels, disponibilités, fiche client et cycle de vie complet du rendez-vous — pas seulement la « prise de RDV ».

Architecture headless

Vous gardez la pleine maîtrise de l’ergonomie et du design de vos fronts ; l’API fournit la logique et les données.

Multimarque par conception

Un seul jeu d’API sert toutes vos marques et enseignes, via le paramètre wlName, sans intégration redondante.

Standards et documentation

REST, OpenAPI 3 et JSON, avec une documentation interactive (Swagger) qui réduit le coût et le risque d’intégration.

Synchronisation incrémentale

Les requêtes par plage de dates et sur la date de modification facilitent les échanges réguliers avec votre CRM et vos outils de pilotage.

Monétisation intégrée

Abonnements, packs, bons cadeaux, codes promo et paiement sont exposés par l’API pour des parcours commerciaux complets.

Catalogue

Les 7 familles d’API

La documentation interactive publique couvre les fonctions cœur ; la documentation détaillée des familles avancées (abonnements, paiement, packs, cadeaux) est disponible sur demande.

1

Version

Connaître la version courante de l’API exposée.

GET /version
2

Comptes Pro (marques)

Réseau d’agences et d’implantations : libellés, adresses, géolocalisation GPS, organisation par marque.

GET /proaccounts · /proaccounts/{proName}
3

Prestations et employés

Motifs, durées, intervenants, offres groupées (bundles, packs) et questionnaires de pré-qualification.

GET /services · /supServices · /bundles · /freePacks · /inquiryQuestionsAndEmployees
4

Disponibilités

Jours et créneaux réellement disponibles, calculés en temps réel selon le motif et l’intervenant.

GET /availabilities
5

Fiche client

Rechercher, créer et mettre à jour la fiche client, la retrouver par clé externe (CRM), récupérer la structure des champs.

GET/POST /customers · GET/PUT /customers/{id} · GET /cardfields
6

Rendez-vous

Cycle de vie complet : création, modification, annulation, restitution, paiement et règles d’annulation.

POST/PUT/DELETE /appointment · GET /appointments · /employees/appointments · /applyPromotionCodes · /gift
7

Abonnements

Souscriptions récurrentes : inscription, validation, renouvellement, résiliation, contrôle d’éligibilité.

GET/POST/DELETE /subscriptions · /subscriptions/renew · /checkForAvailableSubscription
Flux

Orchestration d’un parcours de prise de rendez-vous

01

Référentiels

Agences, motifs et intervenants (/proaccounts, /services).

02

Disponibilités

Créneaux en temps réel (/availabilities).

03

Fiche client

Identifier ou créer le client, rapprocher votre CRM (/customers).

04

Création

Enregistrer le RDV et déclencher la confirmation (POST /appointment).

05

Restitution

Synchroniser et piloter par client, intervenant ou agence.

Confiance

Sécurité & marque blanche

Authentification

Chaque appel est sécurisé par un jeton JWT (en-tête Authorization: Bearer) complété d’une clé API (apiKey). Compatible SSO / OIDC : vos utilisateurs sont authentifiés par votre IAM, le jeton est propagé à l’API.

Marque blanche native

La marque est déterminée par le sous-domaine ou le paramètre wlName, présent sur l’ensemble des méthodes. Les données de chaque marque sont cloisonnées, avec un seul jeu d’API.

Intégrations

Cas d’usage

CRM

Prendre et consulter des rendez-vous directement depuis votre CRM, sans double saisie.

Espace client

Offrir la prise de RDV dans l’espace personnel de vos clients ou collaborateurs.

Application mobile

Brancher vos applications natives sur les mêmes endpoints, en multimarque.

Site web

Composer un parcours de réservation sur mesure aux couleurs de votre marque.

Prêt à intégrer la prise de rendez-vous ?

Accédez à la documentation interactive ou parlez-nous de votre projet : nos équipes vous accompagnent dans l’intégration.

EspaceRendezVous · +33 (0)1 76 34 11 27 · contact@espacerendezvous.com