Développeurs

API de prise de rendez-vous : intégrer Daytio à un site internet

Vous créez ou gérez le site d'un professionnel qui utilise Daytio ? Trois façons d'y mettre sa prise de rendez-vous, de la plus simple à la plus complète. Votre clé développeur se crée ici même, en deux minutes, sans nous écrire.

Trois façons d'intégrer

Commencer en 2 minutes

Créez votre clé développeur vous-même : nom, e-mail, puis le code à 6 chiffres que vous recevez. Gratuit, sans validation de notre part. La clé s'affiche aussitôt.

C'est ce nom que lira le professionnel dans l'e-mail qui lui demande de relier votre site.

Gratuit. Le code envoyé par e-mail est valable 1 heure.

Ensuite, avec votre clé :

  • Le pro a déjà un compte Daytio : il tape son adresse sur votre site, reçoit un code par e-mail et le tape à son tour — son compte est relié (section « Relier le compte d'un pro »). Gratuit pour lui, c'est compris dans son abonnement.
  • Il n'a pas de compte : créez-le par l'API (POST /accounts) ; il reçoit un e-mail pour choisir son mot de passe.
  • Réservez pour vos visiteurs avec votre clé et l'en-tête Daytio-Account : les rendez-vous arrivent dans son agenda.

Pas à pas

  1. 1

    Choisissez l'intégration

    Un simple bouton ? Copiez le lien (section 1). La réservation dans la page ? Copiez le code du widget (section 2) — ces deux-là sont compris dans l'abonnement du pro, rien à demander. Un parcours sur mesure, ou les fiches de vos visiteurs ? Il vous faut l'API : étape 2.

  2. 2

    Créez votre clé développeur

    Section « Commencer en 2 minutes » : nom, e-mail, code reçu par e-mail. Votre clé partenaire (dtp_live_…) s'affiche aussitôt, une seule fois. Gratuit, rien à nous demander.

  3. 3

    Reliez le compte du pro

    Il a un compte : il tape son adresse Daytio sur votre site, vous appelez POST /auth/code, il reçoit un code à 6 chiffres et le tape ; POST /auth/token vous rend son identifiant de compte et un jeton. Il n'en a pas : créez-le avec POST /accounts.

  4. 4

    Vérifiez que tout répond

    Un premier appel, avec votre clé et l'identifiant du compte, doit renvoyer le nom de l'établissement :

    curl https://daytio.com/api/v1/business \
      -H "Authorization: Bearer dtp_live_…" \
      -H "Daytio-Account: 9b1e…"
  5. 5

    Construisez le parcours

    Listez les prestations, affichez les créneaux libres de celle choisie, puis réservez. Si la prestation exige un paiement en ligne, redirigez le client vers le lien Stripe renvoyé : il revient ensuite sur votre site.

1. Le lien de réservation

Chaque pro a une adresse permanente. Ajoutez ?prestation=<nom de la prestation> pour en présélectionner une.

https://daytio.com/votre-salon
https://daytio.com/votre-salon?prestation=Coupe%20femme

2. Le widget

Collez ces deux lignes à l'endroit voulu. Le script crée le cadre et ajuste sa hauteur tout seul — n'écrivez pas d'<iframe> à la main. Blocs disponibles : reservation, horaires (et carte, commande pour un restaurant).

<div data-daytio="reservation" data-slug="votre-salon"></div>
<script src="https://daytio.com/embed.js" async></script>

Le contenu d'un cadre n'est pas indexé avec la page qui le contient : le widget fait réserver, il ne fait pas monter le site dans Google.

3. L'API

Gratuite pour le site d'un pro · clé en 2 minutes

API complète du professionnel (toute sa clientèle) : 25 €/mois, par virement · Demander l'API complète

Adresse de base

https://daytio.com/api/v1

Authentification

Chaque requête porte la clé dans l'en-tête Authorization (ou X-Daytio-Key). Une clé d'établissement (dtk_live_…) désigne le pro : aucun autre identifiant à fournir. Une clé partenaire (dtp_live_…) désigne le compte visé par l'en-tête Daytio-Account.

Authorization: Bearer dtk_live_…
# ou / or
X-Daytio-Key: dtk_live_…

Appels depuis le navigateur ou depuis un serveur

Depuis le navigateur, l'en-tête Origin doit correspondre à un site déclaré sur la clé, sinon la requête est refusée (origin_not_allowed). Une clé dans du JavaScript est lisible par tous les visiteurs : c'est cette liste qui empêche un autre site de l'utiliser. Une clé qui ouvre les fiches clients, et toute clé partenaire, sont refusées depuis un navigateur (server_side_only) : elles ne s'emploient que depuis un serveur. Une clé qui déclare des sites est considérée comme PUBLIQUE, même appelée depuis un serveur : ses limites se comptent par appareil. Pour des appels serveur, créez une seconde clé, sans site déclaré.

Les fonctions de l'API

L'accès d'un établissement comprend une ou plusieurs fonctions, cochées à la demande ; chaque clé n'ouvre que celles cochées à sa création. Les fonctions « fiches clients » et « Comptabilité » sont RÉSERVÉES AU PROFESSIONNEL lui-même (et aux comptes créés par une plateforme partenaire validée) : une clé de développeur n'ouvre que la réservation. Une route appelée sans sa fonction répond 403 module_not_enabled.

  • Réservation(toujours incluse)

    reservation

    L'établissement, ses prestations, collaborateurs et créneaux libres, la réservation et le paiement en ligne.

  • Lire les fiches clients(réservé au professionnel)

    clients_read

    Nom, e-mail, téléphone, adresse, notes, statut — avec recherche.

  • Créer et modifier les fiches clients(réservé au professionnel)

    clients_write

    Depuis le logiciel du pro ou son site : une fiche par adresse e-mail.

  • Historique d'un client(réservé au professionnel)

    client_history

    Ses rendez-vous passés et à venir, annulés compris.

  • Comptabilité(réservé au professionnel)

    accounting

    Tout ce que permet l'écran Comptabilité : réglages, devis (envoi, acceptation en ligne), factures et avoirs, autres ventes, ventes à déclarer (CSV et XML officiel), export annuel. Offre Pro, pros installés en France.

Le site d'un pro relié par un développeur (clé partenaire, compte relié par code ou par « Se connecter avec Daytio ») est GRATUIT : c'est compris dans l'abonnement du pro, comme le widget. L'API complète du pro — toute sa clientèle, avec SA clé — est ouverte par Daytio à réception du virement, et coupée si le paiement ne suit pas (403 api_access_inactive) : ses clés cessent alors de répondre, rien n'est effacé.

Limites

Par clé : 300 lectures par minute, 120 réservations et 600 écritures de fiches clients par heure. Par partenaire : 50 comptes créés par jour (5 tant qu'un partenaire inscrit seul n'a pas été validé par Daytio). Une clé qui déclare des sites (clé publique, posée dans une page) compte ses lectures par appareil, et la limite par appareil de la page Daytio s'applique à ses réservations — qu'elles viennent d'un navigateur ou non. Au-delà : 429 rate_limited.

Format des réponses

JSON. Succès : { "data": … }. Erreur : { "error": { "code", "message" } }. Testez le code, qui est stable ; le message, en français, peut évoluer.

Heures et fuseau

Les instants sont en ISO 8601 (UTC). Affichez au client le champ time, l'heure locale du pro : c'est elle qui fait foi, le client se déplace chez lui.

Points d'accès

  • GET /businessL'établissement : nom, ville, fuseau, devise, règles de réservation, paiement en ligne. reservation
  • GET /servicesLes prestations réservables, dans l'ordre choisi par le pro. reservation
  • GET /staffLes collaborateurs (offre Équipe). Liste vide pour un pro seul. reservation
  • GET /availabilityLes créneaux libres, 1 à 7 jours. Paramètres : services (identifiants séparés par des virgules), from (AAAA-MM-JJ), days, staff, anyStaff=1. reservation
  • POST /bookingsRéserve un créneau. Le créneau est revérifié au moment de la réservation. reservation
  • GET /payments/{sessionId}L'état d'une réservation payée en ligne. reservation
  • POST /requestsDépose une demande de contact ou de devis dans l'écran « Demandes » du pro (badge dans son menu, e-mail au pro). Corps : fullName et phone obligatoires ; email, businessName, message (2 000 caractères) facultatifs. Le module « Demandes » s'ouvre par pro, sur demande à Daytio. reservation
  • GET /clientsLes fiches clients. Paramètres : q (recherche), limit (≤ 100), offset, updatedSince. clients_read
  • GET /clients/{id}Une fiche client. clients_read
  • POST /clientsCrée une fiche. 409 client_exists si l'adresse e-mail est déjà connue (clientId fourni). clients_write
  • PATCH /clients/{id}Modifie une fiche : seuls les champs envoyés changent, null efface. clients_write
  • GET /clients/{id}/appointmentsLes rendez-vous d'un client. Paramètres : from, to (dates ISO), limit (≤ 200). client_history
  • POST /accountsPartenaires : crée le compte Daytio d'un pro. Options : spaceUrl (son espace est sur votre site, partenaire validé) et bookingPage (false : pas de réservation sur daytio.com). partner
  • GET /accountsPartenaires : les comptes que vous gérez (champ relation : « created » pour ceux que vous avez créés). partner
  • POST /auth/codePartenaires : envoie au pro un code de connexion à 6 chiffres (1 h). Corps : { email }. Réponse identique que l'adresse ait un compte ou non. partner
  • POST /auth/tokenPartenaires : échange le code (e-mail, ou retour de « Se connecter avec Daytio ») contre l'identifiant du compte et un jeton de 12 h. partner
  • DELETE /auth/tokenDéconnexion : le jeton de session présenté cesse de valoir. partner
  • GET /partnerPartenaires : votre compte — client_id, nom, sites déclarés, plafond de comptes. partner
  • PATCH /partnerPartenaires : remplace vos sites (adresses de retour). Corps : { sites: ["https://…"] }. partner
  • PATCH /businessModifie le profil : name, description, category, phone, email (contact public), website, address, addressComplement, postalCode, city, siret (14 chiffres, clé contrôlée), legalForm, showFullAddress, brandColor (#RRGGBB ou null), slug (lien de réservation), bookingPage (réservation sur la page daytio.com, true ou false). GET /business renvoie aussi ces champs (objet profile). account
  • POST /business/logoNouveau logo, en multipart/form-data (champ logo) : PNG, JPEG ou WEBP, 5 Mo au plus. account
  • DELETE /business/logoRetire le logo. account
  • GET /services?status=allToutes les prestations, désactivées comprises, avec leur état (active). account
  • POST /servicesCrée une prestation : name, durationMinutes (multiple de 5, 5 à 480), price (null = sans prix), description, category, active, onlinePaymentRequired, staffIds. account
  • PATCH /services/{id}Modifie une prestation : seuls les champs envoyés changent. { active: false } la retire de la réservation. account
  • DELETE /services/{id}Supprime une prestation (les rendez-vous passés gardent leur intitulé). account
  • GET /appointmentsL'agenda : rendez-vous d'une période, avec le client. Paramètres : from, to (AAAA-MM-JJ, inclus, un an au plus), status (confirmed, cancelled, all), clientId, limit (≤ 200), offset. Pro relié : seulement les rendez-vous pris sur votre site. account
  • GET /statsChiffre d'affaires et rendez-vous par jour, semaine (lundi → dimanche) ou mois, à l'heure du pro — les barres du tableau de bord Daytio. Paramètres : granularity (day, week, month ; month par défaut), from, to (AAAA-MM en mois, AAAA-MM-JJ sinon ; par défaut 14 jours, 8 semaines ou 12 mois ; au plus 366 jours, 104 semaines ou 24 mois). totals = la période entière. account
  • GET /stats/summaryL'accueil du tableau de bord en un appel : CA du jour, de la semaine et du mois, rendez-vous du jour et à venir, nombre de clients, taux d'annulation sur 30 jours. account
  • GET /relancesLes relances à afficher en notifications. Paramètres : status (todo par défaut, done, cancelled, all), dueBefore (AAAA-MM-JJ), clientId, limit, offset. managed
  • POST /relancesProgramme une relance : clientId, dueOn (AAAA-MM-JJ), subject, notes, channel (telephone, sms, email). managed
  • PATCH /relances/{id}Modifie une relance ; { status: "done" } la marque faite. managed
  • DELETE /relances/{id}Supprime une relance. managed
  • GET /accounting/settingsRéglages de la Comptabilité (activée, régime de TVA…), profil de facturation du pro (SIRET, forme juridique, adresse…) et mentions encore manquantes. accounting
  • PATCH /accounting/settingsActive la Comptabilité ({ enabled: true }) et/ou modifie ses réglages et le profil de facturation. accounting
  • GET /accounting/quotesDevis (300 derniers) ; ?contactId=, ?status=draft|sent|accepted|refused|cancelled|expired. accounting
  • POST /accounting/quotesNouveau brouillon de devis : contactId, title, client, lines, notes. accounting
  • GET /accounting/quotes/{id}Un devis (statut, totaux, lien « bon pour accord » une fois envoyé). accounting
  • PATCH /accounting/quotes/{id}Modifie un brouillon (champs absents gardés). accounting
  • DELETE /accounting/quotes/{id}Supprime un brouillon. accounting
  • POST /accounting/quotes/{id}/sendEnvoie : mentions contrôlées, numéro, document figé, e-mail au client. accounting
  • POST /accounting/quotes/{id}/resendRenvoie l'e-mail d'un devis envoyé. accounting
  • POST /accounting/quotes/{id}/cancelAnnule un devis envoyé ou accepté. accounting
  • POST /accounting/quotes/{id}/duplicateCopie un devis dans un nouveau brouillon (pour « modifier » un devis envoyé). accounting
  • GET /accounting/quotes/{id}/pdfPDF du devis (aperçu sans numéro pour un brouillon). accounting
  • GET /accounting/invoicesFactures et avoirs (300 derniers) ; ?contactId=, ?kind=invoice|credit_note, ?status=draft|issued. accounting
  • POST /accounting/invoicesNouveau brouillon de facture : le brouillon lui-même, { fromQuoteId } ou { fromAppointmentId }. accounting
  • GET /accounting/invoices/{id}Une facture ou un avoir ; une facture émise porte son reste à annuler. accounting
  • PATCH /accounting/invoices/{id}Modifie un brouillon de facture ou d'avoir (dont paymentMethod, pro en franchise de TVA). accounting
  • DELETE /accounting/invoices/{id}Supprime un brouillon (un document émis ne se supprime jamais). accounting
  • POST /accounting/invoices/{id}/issueÉmet : numéro sans trou, document figé ; { sendEmail } (par défaut : le réglage invoiceEmail). accounting
  • POST /accounting/invoices/{id}/resendRenvoie l'e-mail d'un document émis. accounting
  • POST /accounting/invoices/{id}/duplicateCopie une facture dans un nouveau brouillon. accounting
  • POST /accounting/invoices/{id}/credit-notesOuvre un avoir sur une facture émise, pré-rempli (total ou reste à annuler). accounting
  • GET /accounting/invoices/{id}/pdfPDF de la facture ou de l'avoir. accounting
  • GET /accounting/other-salesAutres ventes d'une période (?period=, période en cours par défaut). accounting
  • POST /accounting/other-salesAjoute une autre vente : saleDate, category, amountTtcCents, vatRate, operationsCount, note. accounting
  • PATCH /accounting/other-sales/{id}Remplace une autre vente. accounting
  • DELETE /accounting/other-sales/{id}Supprime une autre vente. accounting
  • GET /accounting/periodsDernières périodes à déclarer (?count=1 à 24) : totaux, date limite, déclaration, écart. accounting
  • GET /accounting/periods/{key}Une période : totaux par jour, catégorie et taux, autres ventes, déclaration, fichier XML. accounting
  • POST /accounting/periods/{key}/declarationMarque la période déclarée (version suivante en cas de correction). accounting
  • DELETE /accounting/periods/{key}/declarationRetire la dernière version déclarée. accounting
  • GET /accounting/periods/{key}/csvVentes de la période en CSV. accounting
  • GET /accounting/periods/{key}/xmlFichier officiel « flux 10 » de la période, pour la plateforme agréée. accounting
  • GET /accounting/exportArchive ZIP d'une année (?year=) : PDF des factures et avoirs + registre. accounting
GET /business

{
  "data": {
    "name": "Atelier Coiffure",
    "slug": "atelier-coiffure",
    "city": "Quimper",
    "timezone": "Europe/Paris",
    "currency": "EUR",
    "bookingUrl": "https://daytio.com/atelier-coiffure",
    "bookingOpen": true,
    …
  }
}
GET /availability?services=3f0c…&from=2026-10-12&days=7

{
  "data": {
    "timezone": "Europe/Paris",
    "durationMinutes": 45,
    "groupClass": false,
    "days": [
      {
        "date": "2026-10-12",
        "slots": [
          { "startsAt": "2026-10-12T07:00:00.000Z", "time": "09:00" },
          { "startsAt": "2026-10-12T07:45:00.000Z", "time": "09:45" }
        ]
      }
    ]
  }
}

Réserver

Le consentement du client (consent: true) est obligatoire : affichez une case NON pré-cochée « J'accepte que mes données servent à gérer mon rendez-vous ». marketingConsent est une seconde case, facultative et distincte.

POST /bookings

{
  "services": ["3f0c…"],
  "startsAt": "2026-10-12T07:00:00.000Z",
  "client": {
    "firstName": "Camille",
    "lastName": "Martin",
    "email": "camille@example.com",
    "phone": "0612345678"
  },
  "consent": true,
  "returnUrl": "https://www.mon-salon.fr/reservation/merci"
}
  • Rendez-vous créé (201). Le client et le pro reçoivent leur e-mail de confirmation ; le client y trouve son lien pour déplacer ou annuler. manageUrl (ce même lien) n'est renvoyé qu'à une clé du professionnel sans site déclaré : il ouvre l'espace du client, il n'est jamais remis à une clé publique, de développeur ou de partenaire (null).
  • La prestation exige un paiement en ligne (200) : redirigez le client vers checkoutUrl. Rien n'est réservé tant qu'il n'a pas payé.
  • Toujours prévoir le refus : un créneau affiché peut être pris entre-temps (409 booking_failed). Proposez alors d'en choisir un autre.
// 201 — rendez-vous créé / appointment created
{ "data": { "status": "confirmed", "startsAt": "…", "endsAt": "…",
            "partySize": 1, "manageUrl": null } }

// 200 — paiement en ligne exigé / online payment required
{ "data": { "status": "payment_required",
            "checkoutUrl": "https://checkout.stripe.com/…" } }

// 409
{ "error": { "code": "booking_failed", "message": "…" } }

Paiement en ligne

Passez returnUrl (et cancelUrl si besoin), sur un site déclaré sur la clé. Après paiement, le client revient sur returnUrl avec ?daytio_session=… ; interrogez /payments/{id} jusqu'à obtenir confirmed (quelques secondes). Sans returnUrl, le client termine sur la page de confirmation Daytio.

États : confirmed (payé, réservé), processing (payé, confirmation en cours), awaiting_payment, expired (abandonné), failed (créneau pris entre-temps : remboursé).

GET /payments/cs_live_…

{ "data": { "status": "confirmed", "startsAt": "…",
            "amountPaid": 30, "currency": "EUR" } }

Fiches clients (réservé au professionnel)

Pour relier le propre logiciel du professionnel (caisse, CRM, tableur) à ses fiches clients, avec SA clé. Une clé de développeur n'y a JAMAIS accès (403 module_not_enabled) ; un partenaire n'y accède que par « Se connecter avec Daytio », et seulement pour les fiches créées sur son site — sauf sur les comptes qu'il a lui-même créés, une fois validé par Daytio (voir « Plateforme partenaire »). Données personnelles : appelez ces routes uniquement depuis un serveur. Statuts : prospect, client, lost. Le champ name est le nom tel que saisi (souvent le nom complet) : ne le redécoupez pas. L'adresse e-mail identifie un client : deux fiches ne peuvent pas la partager.

GET /clients?q=martin&limit=20

{ "data": { "clients": [
    { "id": "5d2a…", "firstName": "Camille", "name": "Camille Martin",
      "email": "camille@example.com", "phone": "0612345678",
      "status": "client", "marketingConsent": false, … }
  ], "hasMore": false, "limit": 20, "offset": 0 } }

POST /clients
{ "name": "Camille Martin", "email": "camille@example.com", "phone": "0612345678" }

PATCH /clients/5d2a…
{ "notes": "Préfère le samedi", "status": "client" }

GET /clients/5d2a…/appointments?from=2026-01-01T00:00:00Z

{ "data": { "appointments": [
    { "id": "…", "title": "Coupe femme", "status": "confirmed",
      "startsAt": "…", "endsAt": "…", "priceTotal": 45, "staffName": "Léa" }
  ] } }

Partenaires : créer le compte d'un pro

Le professionnel n'a pas encore de compte Daytio ? Avec votre clé partenaire (dtp_live_…, créée en 2 minutes plus haut), créez-le vous-même. Il reçoit un e-mail pour choisir son mot de passe — vous ne connaissez jamais ses identifiants. L'accès API du compte est actif tout de suite et vous est facturé par virement. Tant que Daytio n'a pas validé votre compte partenaire : réservation seule, 5 comptes par jour ; une fois validé, accès complet aux comptes que vous créez (voir « Plateforme partenaire »).

POST /accounts
Authorization: Bearer dtp_live_…

{
  "businessName": "Atelier Coiffure",
  "owner": { "firstName": "Camille", "lastName": "Martin",
             "email": "camille@atelier-coiffure.fr", "phone": "0612345678" },
  "country": "FR",
  "category": "Coiffure",
  "city": "Quimper",
  // Facultatif : son espace est sur votre site / optional: their space is on your website
  "spaceUrl": "https://votre-site.fr/espace-pro",
  "bookingPage": false,
  // Facultatif : profil de facturation / optional: invoicing profile
  "invoicing": { "siret": "123 456 782 00010", "legalForm": "EI",
                 "address": "12 rue de Brest", "postalCode": "29000",
                 "city": "Quimper", "vatRegime": "franchise" }
}

// 201
{ "data": { "id": "9b1e…", "slug": "atelier-coiffure",
            "bookingUrl": "https://daytio.com/atelier-coiffure",
            "status": "active",
            "modules": ["reservation", "clients_read", "clients_write", "client_history", "accounting"],
            "space": "partner", "bookingPage": false,
            "welcomeEmailSent": true, "passwordEmailSent": false,
            "accounting": { "enabled": true, "missingMentions": [] } } }

// Ensuite / then
GET /services
Authorization: Bearer dtp_live_…
Daytio-Account: 9b1e…

Tout sur votre site : avec spaceUrl (une adresse de connexion sur un de vos sites déclarés, partenaire validé), l'e-mail de bienvenue renvoie le pro vers VOTRE site, sans mot de passe Daytio ni lien daytio.com — il ne gère son compte que chez vous. Avec bookingPage: false, sa page daytio.com ne propose plus de réserver : ses clients réservent sur votre site (POST /bookings). Sans ces options, le pro reçoit l'e-mail Daytio habituel et garde sa page. Chaque compte suit son propre choix ; bookingPage se change ensuite par PATCH /business.

Pour agir ensuite sur ce compte (prestations, créneaux, réservations), appelez les autres routes avec votre clé partenaire et l'en-tête Daytio-Account : <id renvoyé>. Un pro qui a déjà un compte (409 account_exists) vous transmet lui-même une clé « développeur », ou vous autorise avec « Se connecter avec Daytio ».

Plateforme partenaire : gérer les comptes que vous créez

Vos professionnels travaillent sur VOTRE plateforme et vous administrez leurs comptes ? Sur un compte que vous avez créé (POST /accounts), votre clé partenaire a tout accès : profil, logo, lien de réservation, prestations, agenda, fiches clients (toutes), chiffre d'affaires, relances et Comptabilité — avec l'en-tête Daytio-Account, comme le reste. Ces comptes sont en offre Pro offerte (c'est vous qui réglez l'accès), Comptabilité activée : transmettez le profil de facturation du pro (SIRET, forme juridique, adresse, TVA) dès la création (invoicing) ou par PATCH /accounting/settings.

  • Réservé aux partenaires VALIDÉS par Daytio (écrivez-nous). Inscrit seul, votre clé n'a que la réservation ; à la validation, les comptes que vous avez déjà créés passent à l'accès complet. Un compte seulement relié : profil, prestations, chiffre d'affaires et agenda du site avec le jeton du pro (voir « Gérer le compte d'un pro relié ») — jamais toute sa clientèle ni ses relances.
  • Le pro en est informé dès la création de son compte (e-mail de bienvenue) : vous gérez son compte avec un accès complet. L'accès API de ces comptes vous est facturé par virement ; impayé, il est suspendu (403 api_access_inactive) — et le tableau de bord du pro avec.
  • Relances : Daytio n'envoie AUCUN e-mail sur ces comptes, ni aux clients du pro, ni au pro. Lisez-les (GET /relances?dueBefore=<aujourd'hui>) et affichez-les en notifications sur votre plateforme ; { status: "done" } les retire.
  • Restent dans le tableau de bord Daytio : horaires, congés, cours collectifs (séances, places), paramètres avancés d'une prestation, pays et fuseau, paiement en ligne (Stripe).
// Toutes ces routes : clé partenaire + compte créé par vous
// All these routes: partner key + an account you created
Authorization: Bearer dtp_live_…
Daytio-Account: 9b1e…

PATCH /business
{ "description": "Photographe de mariage à Nantes", "phone": "0612345678",
  "brandColor": "#8E684E", "slug": "camille-photo" }

POST /services
{ "name": "Reportage mariage", "durationMinutes": 480, "price": 1200 }

PATCH /services/4d2a…
{ "active": false }

GET /stats?granularity=week&from=2026-09-01&to=2026-10-16
// 200 — granularity : day, week ou month (par défaut)
{ "data": { "currency": "EUR", "timezone": "Europe/Paris", "granularity": "week",
            "from": "2026-08-31", "to": "2026-10-18",
            "periods": [ { "period": "2026-10-12", "from": "2026-10-12", "to": "2026-10-18",
                           "revenue": 640, "appointments": 4, "cancelled": 0 }, … ],
            "totals": { "revenue": 4150, "appointments": 27, "cancelled": 2 },
            "clients": { "total": 48, "newInPeriod": 9 } } }

GET /stats/summary
// 200 — l'accueil du tableau de bord / the dashboard home
{ "data": { "today": "2026-10-16",
            "revenue": { "today": { "revenue": 120, "appointments": 2, … },
                         "thisWeek": { "revenue": 640, … }, "thisMonth": { "revenue": 2450, … } },
            "appointments": { "today": 2, "upcoming": 14 }, "clients": { "total": 48 },
            "cancellation": { "days": 30, "rate": 7, "cancelled": 1, "created": 14 } } }

GET /relances?dueBefore=2026-10-15
// 200 — à afficher en notifications / show as notifications
{ "data": { "relances": [ { "id": "…", "status": "todo", "due": "overdue",
                            "dueOn": "2026-10-12", "subject": "Devis album",
                            "client": { "name": "Léa Moreau", "phone": "…" } } ],
            "hasMore": false } }

PATCH /relances/…
{ "status": "done", "notes": "Rappelée, devis envoyé." }

Comptabilité : devis, factures, ventes à déclarer

Tout ce que permet l'écran Comptabilité de Daytio, par l'API (fonction « accounting ») : réglages, devis envoyés et acceptés en ligne, factures aux particuliers et avoirs, autres ventes, ventes à déclarer avec leur fichier officiel, export annuel. Chaque route appelle la même opération que l'écran : mêmes contrôles, mêmes numéros, mêmes documents.

  • Réservé au professionnel lui-même (sa clé, créée « pour moi ») et aux comptes qu'une plateforme partenaire VALIDÉE a créés. Jamais une clé de développeur, jamais un compte seulement relié par « Se connecter avec Daytio » : les factures portent les noms et adresses des clients. Toujours depuis un serveur.
  • Offre Pro ou supérieure, professionnel installé en France (403 accounting_unavailable sinon). La Comptabilité doit être ACTIVÉE : PATCH /accounting/settings { "enabled": true } (403 accounting_disabled tant qu'elle ne l'est pas — seuls les réglages, les PDF et l'export restent ouverts). Un compte créé par une plateforme validée est d'office en Pro, Comptabilité activée.
  • Profil de facturation : ce que le pro remplit sur votre site et qui s'imprime sur ses devis et factures — siret, legalForm, address, addressComplement, postalCode, city, email, phone, tradeRegister, documentsDisplayName, vatRegime, vatNumber. Il se lit et se modifie par GET/PATCH /accounting/settings (missingMentions dit ce qui manque encore), ou se transmet dès la création du compte (champ invoicing de POST /accounts, mêmes noms). Adresse, e-mail, téléphone, SIRET et forme juridique sont aussi ceux de PATCH /business : modifier l'un modifie l'autre. SIRET contrôlé (14 chiffres, espaces tolérés, clé juste).
  • Valeurs : vatRegime vaut "franchise" (franchise en base, TVA non applicable) ou "assujetti" (« je facture la TVA » — jamais "reel") ; avec "assujetti", vatNumber est obligatoire (ex. FR12345678901) et vatFiling vaut "simplifie", "reel_mensuel" ou "reel_trimestriel". missingMentions → champs à compléter : seller_siret = siret ; seller_address = address + postalCode + city ; seller_vat_number = vatNumber. Numérotation attribuée par Daytio à l'envoi d'un devis ou à l'émission d'une facture, sans trou et par année : D-2026-0001 (devis), F-2026-0001 (factures), A-2026-0001 (avoirs).
  • Un document naît BROUILLON (modifiable par PATCH), puis s'envoie (devis) ou s'émet (facture, avoir) : numéro sans trou attribué par Daytio, contenu figé (409 document_locked ensuite). On modifie un devis envoyé en le dupliquant ; on corrige une facture par un avoir. Les mentions obligatoires manquantes sont listées (422 missing_mentions).
  • Montants en CENTIMES d'euro. En franchise de TVA, unitPriceCents est le prix payé et vatRate vaut 0 ; si le pro facture la TVA, unitPriceCents est HORS TAXE et vatRate parmi 0, 2.1, 5.5, 10 et 20. category : services ou goods. Factures aux particuliers seulement (422 b2c_only).
  • Brouillons automatiques : chaque matin, Daytio prépare un brouillon de facture pour chaque rendez-vous payant terminé la veille — à la première activation (enabled: true), ceux des 15 derniers jours, préparés aussitôt (sourceAppointmentId renseigné) — jamais émis : listez-les par ?status=draft, puis émettez-les ou supprimez-les (client absent). Réglage autoInvoiceDrafts (vrai par défaut). Mode de paiement : paymentMethod = card, cash, transfer ou cheque, pour un pro en franchise de TVA seulement (422 payment_method_unavailable sinon) ; paidOnlineCents (lecture seule) reprend l'acompte payé en ligne à la réservation ; settled indique une facture émise « acquittée ». Envoi par e-mail : réglage invoiceEmail (faux par défaut) — tant qu'il est faux, aucune facture ni aucun avoir ne part au client (sendEmail est ignoré, email.error le dit ; resend répond 422 invoice_email_disabled) : récupérez le PDF.
  • Ventes à déclarer : Daytio calcule les totaux par jour (aucune donnée sur les clients) et produit le fichier XML officiel ; Daytio ne transmet RIEN à l'administration — le pro le dépose chez sa plateforme agréée, puis marque la période déclarée. Une facture tardive crée un écart : le fichier devient une rectificative, à déclarer à nouveau.
// Clé du professionnel (pour lui-même), ou clé partenaire + Daytio-Account
// The professional's own key, or a partner key + Daytio-Account
Authorization: Bearer dtk_live_…

GET /accounting/settings
// 200 { "data": { "enabled": false, "vatRegime": "franchise", "siret": "", …,
//                 "missingMentions": ["seller_siret", "seller_address"] } }

PATCH /accounting/settings
{ "enabled": true, "vatRegime": "franchise", "quoteValidityDays": 30,
  // ou / or "vatRegime": "assujetti", "vatNumber": "FR12123456782", "vatFiling": "reel_mensuel"
  "siret": "123 456 782 00010", "legalForm": "EI",
  "address": "12 rue de Brest", "postalCode": "29000", "city": "Quimper" }
// 200 { "data": { "enabled": true, …, "missingMentions": [] } }

POST /accounting/quotes
{ "contactId": "5c1e…", "title": "Mariage — 14 juin",
  "client": { "name": "Jean-Pierre Le Roy", "email": "jp@exemple.fr",
              "address": "3 place Saint-Corentin, 29000 Quimper" },
  "lines": [ { "label": "Coiffure mariée", "quantity": 1,
               "unitPriceCents": 12000, "vatRate": 0, "category": "services" } ] }
// 201 { "data": { "id": "a71f…", "status": "draft", "number": null, … } }

POST /accounting/quotes/a71f…/send
// 200 { "data": { "status": "sent", "number": "D-2026-0007",
//                 "publicUrl": "https://daytio.com/devis/…", "email": { "sent": true } } }
// 422 { "error": { "code": "missing_mentions", "missing": ["seller_siret"] } }

POST /accounting/invoices
{ "fromQuoteId": "a71f…" }            // ou / or { "fromAppointmentId": "…" }
PATCH /accounting/invoices/c903…
{ "serviceDate": "2026-06-14", "servicePlace": "Manoir de Kerazan, Loctudy" }
POST /accounting/invoices/c903…/issue
{ "sendEmail": true }
// 200 { "data": { "status": "issued", "number": "F-2026-0012", … } }

POST /accounting/invoices/c903…/credit-notes    // avoir pré-rempli / prefilled credit note
GET  /accounting/periods?count=6
POST /accounting/periods/2026-B5/declaration
GET  /accounting/periods/2026-B5/xml            // fichier « flux 10 » / official file

Relier le compte d'un pro

Pour qu'un professionnel relie son compte Daytio à votre site — sans jamais vous confier son mot de passe ni une clé — et que vous puissiez réserver pour lui et gérer les fiches de vos visiteurs. Gratuit : c'est compris dans son abonnement (offre Essentiel ou supérieure). Deux façons, qui donnent le même jeton.

Par un code reçu par e-mail (le plus simple)

  1. 1. Sur votre site, le pro tape son adresse Daytio. Votre serveur appelle POST /auth/code { email } avec votre clé partenaire. Daytio envoie à cette adresse un code à 6 chiffres, valable 1 heure, qui nomme votre société. La réponse (202) est la même que l'adresse ait un compte ou non.
  2. 2. Le pro tape le code sur votre site. Votre serveur appelle POST /auth/token { email, code } : vous recevez l'identifiant du compte (accountId) et un jeton de 12 heures. 5 essais par code ; au-delà, demandez-en un autre. Le pro peut en recevoir 3 par heure.
  3. 3. À l'expiration du jeton (401 session_expired), redemandez un code. Le pro garde votre site relié : seul le jeton est à renouveler.
// 1. Le pro tape son adresse / the professional types their address
POST /auth/code
Authorization: Bearer dtp_live_…

{ "email": "camille@atelier-coiffure.fr" }

// 202 — même réponse si l'adresse est inconnue / same response if unknown
{ "data": { "status": "sent", "expiresInMinutes": 60, "message": "…" } }

// 2. Il tape le code reçu / they type the code they received
POST /auth/token
Authorization: Bearer dtp_live_…

{ "email": "camille@atelier-coiffure.fr", "code": "482913" }

// 200
{ "data": { "token": "dts_live_…", "expiresAt": "2026-10-15T08:00:00Z",
            "accountId": "9b1e…", "businessName": "Atelier Coiffure",
            "user": { "email": "camille@atelier-coiffure.fr", "name": "Camille Martin" },
            "scopes": ["clients_read", "clients_write", "client_history"] } }

// 3. Réserver pour vos visiteurs / book for your visitors
POST /bookings
Authorization: Bearer dtp_live_…
Daytio-Account: 9b1e…

// 4. Fiches créées sur votre site / records created on your website
GET /clients
Authorization: Bearer dts_live_…

Par « Se connecter avec Daytio » (redirection)

Le pro se connecte SUR daytio.com, voit ce que votre site demande et clique « Autoriser » ; votre serveur reçoit un code qu'il échange contre le même jeton. Déclarez d'abord votre adresse de retour : PATCH /partner { sites }.

  1. 1. Envoyez le pro sur https://daytio.com/connexion-partenaire avec client_id (votre identifiant partenaire), redirect_uri (adresse de retour sur un de vos sites déclarés), state (valeur aléatoire gardée dans sa session) et response_type=code.
  2. 2. Au retour, vérifiez state, puis échangez le code depuis votre serveur : POST /auth/token avec votre clé partenaire et la MÊME redirect_uri. Le code vaut 5 minutes, une seule fois. Si le pro refuse, il revient avec error=access_denied.
  3. 3. Le jeton (dts_live_…) s'emploie comme une clé sur les routes /clients et sur la gestion du compte (plus bas), depuis votre serveur. À son expiration (401 session_expired), renvoyez le pro sur daytio.com : s'il a déjà autorisé votre site et qu'il est connecté, il revient aussitôt, sans rien recliquer. DELETE /auth/token le déconnecte.
// 1. Lien « Se connecter avec Daytio » / "Sign in with Daytio" link
https://daytio.com/connexion-partenaire?client_id=<id partenaire / partner id>
  &redirect_uri=https%3A%2F%2Fwww.atelier-coiffure.fr%2Fdaytio%2Fretour
  &state=<aléatoire / random>&response_type=code

// 2. Retour / back: …/daytio/retour?code=dtc_…&state=…
POST /auth/token
Authorization: Bearer dtp_live_…

{ "code": "dtc_…", "redirectUri": "https://www.atelier-coiffure.fr/daytio/retour" }

// 200
{ "data": { "token": "dts_live_…", "expiresAt": "2026-10-15T08:00:00Z",
            "accountId": "9b1e…", "businessName": "Atelier Coiffure",
            "user": { "email": "camille@atelier-coiffure.fr", "name": "Camille Martin" },
            "scopes": ["clients_read", "clients_write", "client_history"] } }

// 3. Fiches créées sur votre site / records created on your website
GET /clients
Authorization: Bearer dts_live_…

⚠️ Le jeton ne voit QUE ce qui a été fait sur votre site : les fiches créées par vous (POST /clients) ou nées d'une réservation prise sur votre site, et ces rendez-vous-là. La clientèle que le pro avait déjà dans Daytio reste invisible — une adresse e-mail déjà connue répond 409 client_exists, sans identifiant. Pour réserver (GET /availability, POST /bookings), employez le même jeton — ou votre clé partenaire avec l'en-tête Daytio-Account : <accountId renvoyé>, qui marche aussi quand le pro n'est pas connecté.

Le pro retire l'accès quand il veut (Réglages → Site internet) : vos jetons cessent aussitôt de fonctionner. Prérequis : une offre Essentiel ou supérieure (ni Daytio Mini, ni offre Restaurant) — sinon le pro reçoit un e-mail qui le lui explique, et aucun code.

Gérer le compte d'un pro relié

Avec le jeton de session du pro (dts_live_…), votre site gère aussi son compte, comme il le ferait dans Daytio : profil et logo (GET/PATCH /business, /business/logo), prestations (GET /services?status=all, POST, PATCH, DELETE /services), équipe (GET /staff), créneaux et réservations dans son agenda (GET /availability, POST /bookings, GET /payments/{id}), chiffre d'affaires (GET /stats, GET /stats/summary) et agenda (GET /appointments) — limité aux rendez-vous pris sur votre site. Le chiffre d'affaires n'est fait que de totaux : aucun client n'y apparaît. Toujours depuis votre serveur.

C'est le pro connecté qui ouvre son compte : votre clé partenaire seule n'y suffit pas (403 session_required). Les relances et la clientèle que le pro avait déjà restent réservées aux comptes que vous avez créés.

// Jeton du pro relié / the linked professional's token
Authorization: Bearer dts_live_…

GET /stats/summary
GET /stats?granularity=day
GET /services?status=all
PATCH /services/4d2a…
{ "price": 45 }

GET /appointments?from=2026-10-01&to=2026-10-31
// seulement les RDV pris sur votre site / only those booked on your website

Codes d'erreur

  • missing_api_keyPas de clé dans la requête.
  • invalid_api_keyClé inconnue ou révoquée.
  • origin_not_allowedAppel navigateur depuis un site non déclaré sur la clé.
  • rate_limitedTrop de requêtes. Réessayez plus tard.
  • account_unavailableCompte du pro désactivé.
  • invalid_requestParamètre manquant ou invalide (le message dit lequel).
  • not_foundRessource introuvable.
  • booking_failedRéservation refusée (créneau pris, préavis, téléphone manquant…).
  • return_url_not_allowedreturnUrl / cancelUrl hors des sites déclarés.
  • unsupported_accountCompte restaurant (utilisez le widget ou le lien), ou offre sans API (Daytio Mini).
  • api_access_inactiveCompte partenaire suspendu, ou API complète du pro pas encore ouverte / suspendue (paiement).
  • module_not_enabledFonction non ouverte pour cette clé ou ce compte — les fiches clients ne s'ouvrent jamais à un développeur.
  • server_side_onlyClé « fiches clients » ou partenaire utilisée depuis un navigateur.
  • account_requiredClé partenaire sans en-tête Daytio-Account.
  • partner_onlyRoute réservée aux clés partenaires (dtp_live_…).
  • account_existsCe pro a déjà un compte Daytio : il vous transmet une clé.
  • client_existsUne fiche porte déjà cette adresse e-mail (clientId fourni, sauf si elle n'a pas été créée sur votre site).
  • invalid_grantCode invalide, expiré ou déjà utilisé (code e-mail : 1 h, 5 essais ; code de redirection : 5 min), ou redirect_uri différente.
  • session_expiredJeton expiré, ou accès retiré par le pro : redemandez un code (ou reconnectez-le avec Daytio).
  • managed_account_onlyRelances : réservées aux comptes que vous avez créés (POST /accounts), avec un compte partenaire validé par Daytio.
  • session_requiredGestion du compte : appelez la route avec le jeton de session du pro (POST /auth/token), ou sur un compte que vous avez créé avec un compte partenaire validé.
  • accounting_unavailableComptabilité : réservée à l'offre Pro (ou supérieure), pour un professionnel installé en France.
  • accounting_disabledLa Comptabilité n'est pas activée sur ce compte : PATCH /accounting/settings { "enabled": true }, ou Réglages → Comptabilité.
  • document_lockedDocument déjà envoyé ou émis : il est figé. Dupliquez un devis ; corrigez une facture par un avoir.
  • invalid_stateOpération impossible dans l'état actuel (devis non accepté, rendez-vous annulé, facture déjà entièrement annulée…). Le message dit lequel.
  • missing_mentionsMentions obligatoires manquantes pour envoyer ou émettre : la liste est dans « missing » (SIRET, adresse, n° de TVA, client…).
  • b2c_onlyDaytio fait les factures aux particuliers seulement (pas aux entreprises).
  • credit_note_invalidAvoir refusé : vide, taux absent de la facture, ou plus que le reste à annuler (détail dans « creditProblems »).
  • period_openLa période n'est pas terminée : elle se déclare (et son fichier XML se produit) le lendemain de sa fin.
  • period_declaredJournée d'une période marquée déclarée : retirez la déclaration (DELETE …/declaration) pour modifier ses autres ventes.
  • already_declaredPériode déjà déclarée, et rien n'a changé depuis.
  • file_unavailableFichier non disponible : SIRET absent ou invalide, aucune vente, ou taux refusé par l'administration (motif dans « reason »).
  • payment_method_unavailableMode de paiement refusé : il n'est proposé qu'aux pros en franchise de TVA (un pro qui facture la TVA devrait sinon utiliser une caisse certifiée).
  • invoice_email_disabledEnvoi par e-mail désactivé : le pro n'a pas activé le réglage invoiceEmail (Réglages → Comptabilité). Récupérez le PDF, ou activez le réglage.
  • requests_disabledDemandes : le module « Demandes » n'est pas ouvert sur ce compte (sur demande à Daytio). Rien n'a été enregistré.
  • server_errorErreur de notre côté : réessayez. Rien n'a été enregistré à moitié.

Exemple complet (JavaScript)

const API = "https://daytio.com/api/v1";
const KEY = "dtk_live_…"; // de préférence côté serveur / server-side if possible

async function daytio(path, init = {}) {
  const res = await fetch(API + path, {
    ...init,
    headers: {
      Authorization: "Bearer " + KEY,
      "Content-Type": "application/json",
      ...init.headers,
    },
  });
  const json = await res.json();
  if (json.error) throw Object.assign(new Error(json.error.message), json.error);
  return json.data;
}

// 1. Prestations / services
const services = await daytio("/services");

// 2. Créneaux libres sur 7 jours / free slots over 7 days
const today = new Date().toISOString().slice(0, 10);
const { days } = await daytio(
  "/availability?services=" + services[0].id + "&from=" + today + "&days=7",
);

// 3. Réserver le premier créneau / book the first slot
const slot = days.find((d) => d.slots.length)?.slots[0];
try {
  const booking = await daytio("/bookings", {
    method: "POST",
    body: JSON.stringify({
      services: [services[0].id],
      startsAt: slot.startsAt,
      client: { firstName: "Camille", lastName: "Martin", email: "camille@example.com" },
      consent: true, // case cochée par le client / box ticked by the client
      returnUrl: location.origin + "/reservation/merci",
    }),
  });
  if (booking.status === "payment_required") {
    location.href = booking.checkoutUrl; // Stripe, puis retour / then back
  } else {
    showConfirmation(booking); // booking.startsAt (lien de gestion : par e-mail / sent by email)
  }
} catch (e) {
  if (e.code === "booking_failed") askForAnotherSlot(e.message);
  else throw e;
}

// 4. Page /reservation/merci : état du paiement / payment status
const session = new URLSearchParams(location.search).get("daytio_session");
if (session) {
  const payment = await daytio("/payments/" + encodeURIComponent(session));
  // payment.status : confirmed | processing | awaiting_payment | expired | failed
}

Comptes restaurant : l'API couvre les rendez-vous et les cours. Pour les tables et la vente à emporter, utilisez le widget ou le lien.

API complète du professionnel

Pour relier le propre logiciel du pro (caisse, CRM) à TOUTE sa clientèle, avec sa propre clé. 25 €/mois par établissement, toutes fonctions comprises. Facturation mensuelle par virement : nous vous envoyons un RIB, l'accès est ouvert à réception. Vous construisez le site d'un pro ? Inutile : votre clé développeur (plus haut) suffit, et c'est gratuit.

Vous êtes

Une question ?

Écrivez-nous, avec le nom de l'établissement concerné. daytio.com/contact