# DooLight > DooLight est un outil gratuit pour trouver une date commune : on crée un calendrier, on partage le lien, chacun indique ses disponibilités. Pas de compte ni de connexion : l'identifiant ("hash") du calendrier, visible dans le lien `https://doolight.org/?cal=`, suffit pour le lire et le modifier. Les IA et agents peuvent utiliser DooLight gratuitement, sans clé d'API : connecteur MCP, API JSON ou simples liens (GET), en respectant le protocole ci-dessous. ## Pour les utilisateurs - [Page « DooLight pour les IA »](https://doolight.org/ia.html): connecteur MCP, phrase à copier, exemples ## Connecteur MCP (le plus simple) Serveur MCP distant, gratuit et sans clé : `https://doolight.org/api/mcp` (outils : create_calendar, get_calendar, find_best_slots, set_availability). ## Protocole à respecter (IA qui ne savent que visiter des URL, GET) L'humain qui vous envoie ici ne connaît peut-être pas DooLight : c'est à vous d'appliquer ce protocole pour lui. N'agissez qu'à sa demande ; ne créez pas de calendriers pour tester. ### Scénario A — il veut organiser quelque chose (créer) 1. Visitez `https://doolight.org/api/v1/ai/create?name=Tournoi&days=sam.,dim.&slots=Après-midi,Soir&creator=🤖 IA` : rien n'est créé, la réponse (`status: preview`) contient `confirm_url`. 2. Visitez `confirm_url` (jeton signé, ~1 h) : le calendrier est créé, la réponse contient `share_url`. ### Scénario B — il vous donne un lien déjà paramétré (`https://doolight.org/?cal=HASH`) 1. Lisez `https://doolight.org/api/v1/calendars/HASH` (jours, créneaux, participants, meilleurs créneaux, consignes `for_ai`). 2. Mettez à jour les disponibilités de la personne dont il vous donne le prénom (demandez-lui prénom et disponibilités s'il manquent) : `https://doolight.org/api/v1/ai/set?hash=HASH&name=Alice&week=16/11/2026&cases=sam.-Soir,dim.-Soir&mode=add` - `mode=add` ajoute des cases, `mode=remove` en retire, `mode=replace` (défaut) remplace tout. Le participant est créé s'il n'existe pas. - Ne modifiez que cette personne. Un participant `locked: true` ne peut pas être modifié. ### Scénario C — vous ne pouvez appeler aucune URL (outil web limité aux pages indexées, ou aucun outil) Fabriquez un lien pré-rempli (texte seulement) et donnez-le à l'humain : il le clique et valide. - **Créer** : `https://doolight.org/?name=TITRE&days=COLONNES&slots=LIGNES&poll=1` — `days` et `slots` sont des listes séparées par des virgules. Jours de semaine récurrents : `lun.,mar.,mer.,jeu.,ven.,sam.,dim.` (sans `poll`). Dates précises : `poll=1` et des libellés lisibles sans tiret (`Ven 12 mars,Sam 13 mars`). Exemple : `https://doolight.org/?name=Anniversaire%20de%20Julien&days=Ven%2012%20mars,Sam%2013%20mars,Dim%2014%20mars&slots=Matin,Apr%C3%A8s-midi,Soir&poll=1` - **Mettre à jour une personne** : `https://doolight.org/?cal=HASH&me=PRENOM&cases=COLONNE-LIGNE,COLONNE-LIGNE&mode=add` (`week=LUNDI_jj/mm/aaaa` seulement pour un calendrier par jours de semaine). L'humain voit « Une IA a préparé une mise à jour pour PRENOM » et clique « Appliquer et enregistrer ». - Encodez le texte pour une URL (espace = `%20`). ### Ce que vous devez rendre à l'humain à la fin Le **lien du calendrier DooLight paramétré** (`share_url`, de la forme `https://doolight.org/?cal=HASH`) et un court résumé de ce que vous avez fait (calendrier créé, ou disponibilités enregistrées pour tel prénom). C'est ce lien que l'humain ouvre pour voir le résultat. ### Autres routes - Meilleurs créneaux : `https://doolight.org/api/v1/calendars/HASH/best-slots?limit=5` - Guide JSON complet : `https://doolight.org/api/v1/ai` ## Documentation - [Spécification OpenAPI](https://doolight.org/openapi.json): toutes les routes et formats - [Serveur MCP](https://doolight.org/mcp/README.md): outils prêts à l'emploi pour Claude, ChatGPT, Cursor... ## API (base : https://doolight.org/api/v1) - `POST /calendars` : crée un calendrier. Corps : `{"name": "Repas d'équipe", "days": ["lun.","mar."], "slots": ["Matin","Midi"], "poll": false, "creator": {"name": "Claude 🤖"}}`. Renvoie `hash` et `share_url` (le lien à donner aux humains). - `GET /calendars/{hash}` : nom, jours, créneaux, participants, disponibilités et meilleurs créneaux. - `GET /calendars/{hash}/best-slots?limit=5` : les créneaux où le plus de participants sont disponibles. - `PUT /calendars/{hash}/participants/{name}` : crée ou modifie les disponibilités d'un participant. Corps : `{"mode": "add", "color": "#1FF012", "weeks": [{"week": "16/11/2026", "selectedCases": ["lun.-Matin", "mar.-Midi"]}]}` (`mode` : replace par défaut, add, remove). ## Règles importantes - Une case s'écrit `-`, avec exactement les libellés de `days` et `slots` du calendrier (ex. `lun.-Matin`). - `week` est la date du LUNDI de la semaine au format `jj/mm/aaaa`. En mode sondage (`mode: "poll"`), `week` vaut `"sondage"`. - `mode` vaut `replace` par défaut (remplace toutes les disponibilités du participant) ; préférez `add` ou `remove` pour ne pas effacer ses autres choix. - Un participant qui a posé un code de vérouillage (`locked: true`) ne peut pas être modifié : l'API répond 403. - Si le calendrier est en « réponse anonyme », l'API ne donne que les nombres de participants par créneau. - Pour distinguer les participants IA, préfixez le nom par 🤖 (ex. `🤖 Claude`). - Donnez toujours le `share_url` à l'humain : c'est lui qui voit le calendrier dans l'application.