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.startedcall.completedcall.transferredcall.abandoned
Rendez-vous
appointment.bookedappointment.rescheduledappointment.cancelledappointment.no_show
Questionnaire et résumé
intake.startedintake.completedsummary.createdsummary.signed
Sécurité
flag.raisedescalation.startedescalation.acknowledged
Intégration
emr.write.succeededemr.write.failed
Tâches
task.createdtask.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.