1. Accueil
  2. Développeurs
API · SDK · Widget · MCP

L'API de réservation pour développeurs et agences.

Disponibilités, rendez-vous, clients et paiements, décrits dans un contrat OpenAPI. Construisez votre propre parcours, posez le widget sur un site, ou laissez un assistant IA préparer la configuration.

$ npm i @sutempo/sdk

Bac à sable gratuit, ouvert à tousPaquets npm sous licence MIT

import { PlatformClient } from "@sutempo/sdk";

const client = new PlatformClient("https://sutempo.com", process.env.PLATFORM_API_KEY);

// Les créneaux libres, toutes personnes confondues, sur 7 jours
const { slots } = await client.searchAvailability({
  path: { tenantId },
  query: { serviceId, locationId, from: "2026-10-01", to: "2026-10-07" },
});

// Retenir le premier, rejouable sans doublon
const held = await client.holdAppointment({
  path: { tenantId },
  body: { locationId, serviceId, resourceId: slots[0].resourceId, startsAt: slots[0].startsAt },
  idempotencyKey: crypto.randomUUID(),
});
sutempoWebhook reçu · 200appointment.confirmed · signé v1
Par où commencer

Six entrées, une seule documentation.

Tarifs développeurs

Payez pour gérer des commerces, pas pour appeler l'API.

Le compte développeur compte les commerces actifs en même temps. Un commerce archivé libère sa place.

Free
0 €

Un freelance, quelques clients.

  • Jusqu'à 3 commerces actifs
  • Bac à sable compris
  • Console, clés et webhooks
Créer un compte développeur
Agence
49 € HT / mois

Une agence et son portefeuille.

  • Jusqu'à 20 commerces actifs
  • Bac à sable compris
  • Console, clés et webhooks
Demander l'offre Agence

Sur un vrai commerce, l'accès API s'ouvre avec l'offre Pro de ce commerce et l'autorisation révocable de son commerçant. L'abonnement Pro (29 € HT par mois et par lieu) est payé par le commerçant, pas par le développeur. Tarifs commerçants

Aperçu de la documentation

La documentation, sur le même domaine.

Une barre latérale par parcours, un contenu court, des extraits à copier.

sutempo.com/developpeurs/docs/demarrage-rapide
Démarrage rapide

Trois appels contre le commerce fictif de votre bac à sable. Créez une clé de test dans la console, puis copiez les commandes dans l'ordre.

1Lister les prestations

export SUTEMPO_KEY="<votre clé de test>"
curl -s https://sutempo.com/v1/business-tenants/$TENANT/services \
  -H "authorization: Bearer $SUTEMPO_KEY"

2Lire les créneaux d'une journée

curl -s "https://sutempo.com/v1/business-tenants/$TENANT/availability/search?locationId=<id>&serviceId=<id>&from=AAAA-MM-JJ&to=AAAA-MM-JJ" \
  -H "authorization: Bearer $SUTEMPO_KEY"

3Retenir un créneau

curl -s -X POST https://sutempo.com/v1/business-tenants/$TENANT/appointments/hold \
  -H "authorization: Bearer $SUTEMPO_KEY" -H "content-type: application/json" \
  -H "idempotency-key: $(uuidgen)" \
  -d '{"locationId":"<id>","serviceId":"<id>","resourceId":"<slot resourceId>","startsAt":"<slot startsAt>"}'

La clé d'idempotence rend l'appel rejouable sans doublon. Une clé de test ne touche que le bac à sable.

Sécurité et fiabilité

Ce que le code fait déjà.

Clés limitées et hachées

Permissions explicites, commerces attribués, stockage haché, affichage une seule fois.

Webhooks signés

HMAC-SHA256 sur horodatage et corps, destinations en HTTPS uniquement.

Quotas et limites de débit

Par clé, par commerce et global. Au-delà : 429 avec Retry-After.

Données en Europe

Application chez Vercel et base chez Neon, région Francfort.

Sécurité et signalement de vulnérabilités →

Votre premier appel, en cinq minutes.

Un compte développeur gratuit, des clés de test sur un commerce fictif : aucun e-mail ni paiement réel.