Documentation technique — RETO Solidarité

Sommaire

1. Présentation du service
2. Points d'accès (endpoints)
3. Structure des données
4. Exemples de code
5. Intégration IA
6. Conditions d'utilisation
7. Contact

1. Présentation du service

RETO Solidarité est un annuaire numérique de volontaires — bénévoles ou professionnels — qui proposent leurs compétences à la solidarité et aux personnes vulnérables.

Chaque volontaire dispose d'une fiche publique accessible en HTML et référencée dans un registre JSON librement consultable. Cette architecture permet à n'importe quel système externe — application, site web ou intelligence artificielle — d'interroger le registre et d'exploiter les données.

2. Points d'accès (endpoints)

Registre complet (JSON)

GET https://reto.dedici.org/export/registre.json

Retourne la liste complète des fiches actives au format JSON (UTF-8). Seules les fiches au statut ACTIF sont exposées. Pas d'authentification requise. CORS activé.

Annuaire HTML — recommandé pour les IA avec navigateur

GET https://reto.dedici.org/export/annuaire.php

Page HTML présentant l'intégralité des fiches actives en texte lisible. Chaque fiche affiche ses rôles, zone, présence, engagement, disponibilité, compétences et un lien direct. Conçue pour être lue directement par les IA dotées d'un navigateur (ChatGPT, Claude, Gemini, Perplexity...).

Fiche individuelle (HTML)

GET https://reto.dedici.org/fiches_html/{id}.html

Page HTML complète du profil d'un volontaire. L'identifiant {id} est disponible dans le champ id du registre JSON (format fiche_AAAAMMJJ_XXXXXXXX).

Description du service pour les IA (llms.php)

GET https://reto.dedici.org/llms.php

Texte brut décrivant le service et ses endpoints, au format standardisé llms.txt (llmstxt.org).

3. Structure des données

Exemple de fiche réelle retournée par le registre JSON :

{
  "id": "fiche_20260620_0526e602",
  "statut": "ACTIF",
  "titre": "Aide-soignante bénévole à Nantes",
  "roles": [
    { "couleur": "Vert", "intensite": 3 },
    { "couleur": "Noir", "intensite": 2 }
  ],
  "zone": "Nantes",
  "rayon_km": 10,
  "type_presence": "présentiel",
  "engagement": "régulier",
  "capacites": ["accompagnement à domicile", "aide à la toilette"],
  "disponibilite": "lundis et mercredis matin",
  "url_fiche": "/fiches_html/fiche_20260620_0526e602.html",
  "timestamp_creation": "2026-06-20T15:55:12+02:00",
  "contact_disponible": true
}

Champ	Type	Description
id	string	Identifiant unique — format `fiche_AAAAMMJJ_XXXXXXXX`
statut	string	Toujours `ACTIF` dans l'API publique
titre	string	Intitulé du profil du volontaire
roles	array	Liste d'objets `{"couleur", "intensite"}` — voir codes couleur ci-dessous
zone	string	Ville ou zone géographique déclarée
rayon_km	number\|null	Rayon d'action en km autour de la zone
type_presence	string	`présentiel` / `distance` / `mixte`
engagement	string	`ponctuel` / `régulier` / `mixte`
capacites	array	Compétences et apports concrets (liste de textes libres)
disponibilite	string	Fréquence de disponibilité déclarée
url_fiche	string	Chemin relatif vers la fiche HTML — préfixer avec `https://reto.dedici.org`
timestamp_creation	string	Date de création au format ISO 8601
contact_disponible	boolean	`true` si le volontaire a fourni une adresse de contact

Codes couleur des rôles

Couleur	Signification
Rouge	Défense et protection des droits
Vert	Démarches administratives et médiation
Noir	Aide pratique, présence, soutien quotidien
Bleu	Partage d'expérience (personne concernée)
Jaune	Soutien institutionnel

4. Exemples de code

JavaScript (fetch)

fetch('https://reto.dedici.org/export/registre.json')
  .then(r => r.json())
  .then(data => {
    // data.fiches = tableau de toutes les fiches actives
    data.fiches.forEach(fiche => {
      const url = 'https://reto.dedici.org' + fiche.url_fiche;
      console.log(fiche.titre, '—', fiche.zone, '—', url);
    });
  });

Python (requests)

import requests

r = requests.get('https://reto.dedici.org/export/registre.json')
registre = r.json()

for fiche in registre['fiches']:
    url = 'https://reto.dedici.org' + fiche['url_fiche']
    print(fiche['titre'], '—', fiche['zone'], '—', url)

5. Intégration IA

Méthode recommandée — lecture de l'annuaire HTML

Pour une IA dotée d'un navigateur web (ChatGPT, Claude, Gemini, Perplexity...), la méthode la plus fiable est de lire directement l'annuaire HTML :

Avant de répondre, accède avec ton navigateur à :
https://reto.dedici.org/export/annuaire.php

Cette page liste tous les volontaires actifs. Pour chaque profil, la dernière
ligne indique "Lien direct : https://..." — copie cette URL telle quelle
dans ta réponse pour chaque profil présenté.

Méthode alternative — API JSON

Pour un agent avec accès HTTP direct (sans navigateur) :

Interroge l'API REST à l'adresse :
https://reto.dedici.org/export/registre.json

Le JSON contient un tableau "fiches" avec pour chaque volontaire :
titre, zone, rayon_km, type_presence, engagement, capacites,
disponibilite, roles (couleur), url_fiche, contact_disponible.
L'URL complète d'une fiche = 'https://reto.dedici.org' + url_fiche

Fichier llms.php

Le fichier https://reto.dedici.org/llms.php suit le standard llms.txt (llmstxt.org) et décrit le service en texte brut. Un agent qui lit ce fichier dispose immédiatement de tous les endpoints et de la structure des données.

6. Conditions d'utilisation

Données publiques, librement consultables et réutilisables
Usage non commercial uniquement
Ne pas utiliser pour démarcher directement les volontaires sans leur accord explicite
Citer la source RETO Solidarité — DEDIĈI en cas de réutilisation publique
Signaler tout contenu inapproprié via la page de signalement

7. Contact

Contact non renseigné — configurer site.contact_email dans config/config.json