Hub développeur et API publique
Tout ce dont les développeurs ont besoin pour intégrer yAppointment dans leurs propres produits — une REST API publique, OAuth 2.1 pour l'accès délégué, des webhooks signés et un TypeScript SDK prêt à l'emploi.
Read the DocsUne plateforme développeur complète
Des blocs de construction prêts pour la production pour connecter yAppointment à vos applications, workflows et intégrations
REST API publique
Une REST API propre et prévisible sur /api/v1 pour lire et écrire vos données d'entreprise, de réservation et de clients — avec des clés d'idempotence pour que les tentatives ne créent jamais de double réservation.
- Lire et écrire les données d'entreprise, de réservation et de clients
- Création de réservations idempotente avec des clés d'idempotence
- Gérer vos endpoints webhook par programmation
- Prix retournés en unités mineures (centimes) pour des calculs précis
- Réponses JSON cohérentes et bien structurées
OAuth 2.1 + PKCE
Permettez à vos utilisateurs de connecter leur compte yAppointment à votre application en toute sécurité avec le flux Authorization-Code et PKCE — sans partage de mot de passe, accès à portée limitée uniquement.
- Flux Authorization-Code avec PKCE pour un accès délégué sécurisé
- Portées granulaires : read/write:bookings et read/write:customers
- Accès au profil et aux analyses via read:profile et read:analytics
- Gestion des webhooks via la portée webhooks:manage
- Les utilisateurs accordent l'accès sans jamais partager leurs identifiants
Clés API serveur et publiques
Émettez des clés serveur (yapp_sk_*) pour les intégrations backend et des clés publiques (yapp_pk_*) pour une utilisation côté client, avec des environnements live et de test totalement séparés.
- Clés serveur (yapp_sk_*) pour les appels serveur à serveur de confiance
- Clés publiques (yapp_pk_*) pour une utilisation sécurisée côté client
- Environnements live et de test séparés pour développer en toute confiance
- Faire pivoter les clés à tout moment depuis votre tableau de bord
- Tester sur des données sandbox avant de passer en production
Webhooks signés
Soyez notifié dès qu'un changement se produit. yAppointment délivre 9 types d'événements à vos endpoints HTTPS avec des tentatives automatiques et un suivi complet des livraisons.
- 9 types d'événements couvrant les réservations, clients, services et employés
- Événements booking.created, booking.updated et booking.cancelled
- Endpoints HTTPS uniquement avec un secret de signature whsec_
- Signatures HMAC-SHA256 dans l'en-tête yapp-signature
- Tentatives automatiques avec suivi des livraisons, plus des livraisons de test depuis le tableau de bord
Getting Started
Start building with our SDK or REST API in minutes. Full documentation and interactive examples at developers.yappointment.com.
View Documentationimport { YAppointmentClient } from
'@lohisoftsro/yappointment-sdk';
const client = new YAppointmentClient({
apiKey: process.env.API_KEY,
baseUrl: 'https://api.yappointment.com'
});
// Create a booking
const booking = await client.bookings.create({
serviceId: 'srv_123',
customerId: 'cst_456',
startTime: '2025-07-01T10:00:00Z',
idempotencyKey: 'req_xyz789'
});
console.log('Booked:', booking.id);Conçu pour une excellente expérience développeur
Les outils et la documentation qui rendent l'intégration de yAppointment rapide et agréable
TypeScript SDK
Évitez le code répétitif avec notre TypeScript SDK officiel sur npm — @lohisoftsro/yappointment-sdk — généré directement depuis notre spec OpenAPI, avec support ESM et CJS.
Documentation développeur interactive
Explorez chaque endpoint sur developers.yappointment.com avec une référence API Scalar interactive que vous pouvez lire, rechercher et tester au fur et à mesure que vous développez.
Modes live et test
Des clés API live et de test séparées vous permettent de développer et d'expérimenter en toute sécurité, puis de basculer en production quand vous êtes prêt — sans toucher aux données réelles.
Tentatives sécurisées
Les clés d'idempotence rendent la création de réservations sûre à réessayer, afin que les problèmes réseau ne se transforment jamais en rendez-vous en double.
Prêt à voir ce qui change ?
14 jours. Accès complet. Sans carte bancaire. Qu'avez-vous à perdre ?
Des entrepreneurs à travers l'Europe ont remplacé le chaos administratif par une seule plateforme qui fonctionne vraiment. Rejoignez-les dès aujourd'hui.
14 jours d'essai gratuit • Sans commission — toujours • Annulation à tout moment