Aller au contenu
DcoyoAI Front Desk

Développeurs

La même API que celle de notre tableau de bord.

Une API REST versionnée et des webhooks signés pour les rendez-vous, les questionnaires, les résumés, les appels et les tâches. L’API est en conception et sera ouverte aux partenaires dès la première version.

Conventions.

Prévisible par défaut : une intégration s’écrit une fois et inspire confiance.

Style
REST sur HTTPS, JSON, version dans le chemin.
Authentification
Identifiants client OAuth 2.0, jetons de courte durée, portées par ressource.
Idempotence
Un en-tête Idempotency-Key sur chaque POST. Les clés sont conservées 24 heures.
Pagination
Par curseur, jusqu’à 100 éléments par page.
Erreurs
JSON au format problem details, avec un code stable et un identifiant de requête.
Limites de débit
Par client et par clinique. 429 avec Retry-After.
Locataires
Un jeton est lié à une seule clinique, ou à un partenaire disposant d’autorisations explicites par clinique.
Heure
ISO 8601 en UTC, avec le fuseau horaire de la clinique fourni séparément.

Points de terminaison.

  • GET/v1/availabilityRechercher des plages réservables par professionnel, type et périodeappointments:read
  • POST/v1/appointmentsRéserver une plageappointments:write
  • PATCH/v1/appointments/{id}Déplacer ou annulerappointments:write
  • POST/v1/intakesCréer un questionnaire pour un rendez-vous; renvoie le lien patientintakes:write
  • GET/v1/intakes/{id}Statut et progression d’un questionnaireintakes:read
  • GET/v1/summaries/{id}Résumé structuré, avec ses versionssummaries:read
  • GET/v1/summaries/{id}/documentPDF rendu ou texte brutsummaries:read
  • GET/v1/callsJournal d’appels, résumé et transcriptioncalls:read
  • PATCH/v1/tasks/{id}Attribuer et résoudre les éléments de la filetasks:write
  • POST/v1/webhooksEnregistrer un point de terminaison et les événements souhaitéswebhooks:write

Webhooks.

Les charges utiles contiennent des identifiants et des statuts, jamais de contenu clinique. Votre service récupère le détail avec son propre jeton.

Appels

  • call.started
  • call.completed
  • call.transferred
  • call.abandoned

Rendez-vous

  • appointment.booked
  • appointment.rescheduled
  • appointment.cancelled
  • appointment.no_show

Questionnaire et résumé

  • intake.started
  • intake.completed
  • summary.created
  • summary.signed

Sécurité

  • flag.raised
  • escalation.started
  • escalation.acknowledged

Intégration

  • emr.write.succeeded
  • emr.write.failed

Tâches

  • task.created
  • task.resolved
POST https://partner.example/hooks/dcoyo
Dcoyo-Signature: t=1794400000,v1=5f2c...
Dcoyo-Event-Id: evt_01JC...

{
  "id": "evt_01JC...",
  "type": "intake.completed",
  "created_at": "2026-11-11T14:05:38Z",
  "clinic_id": "cl_8f2...",
  "data": {
    "intake_id": "in_3aa...",
    "appointment_id": "ap_91c...",
    "summary_id": "sum_01J...",
    "completeness": { "required_filled": 7, "required_total": 8 },
    "flags": ["urgent_same_day"]
  }
}
  • La signature est un HMAC-SHA256 de l’horodatage et du corps, calculé avec le secret de votre point de terminaison. Rejetez tout ce qui date de plus de 5 minutes.
  • La livraison se fait au moins une fois. Dédoublonnez selon l’identifiant de l’événement.
  • Les livraisons échouées sont relancées avec un délai exponentiel pendant 24 heures.

Chaque visite, mieux préparée.

Expliquez-nous le fonctionnement de votre clinique. Nous vous montrerons Dcoyo qui répond à votre téléphone, prend les rendez-vous dans votre calendrier et prépare vos cliniciens.