Points de terminaison (prévus)
Ressources en lecture seule prévues en premier.
URL de base prévue (pas encore construite) : https://api.communati.ca/v1beta (bêta) → https://api.communati.ca/v1 (stable). Tels que prévus, tous les points de terminaison renverraient application/json, avec application/geo+json sur les points géo via l'en-tête Accept.
GET/organizations
Liste les organisations approuvées. Filtres : region, type, indigenous_led, has_active_programs. Pagination par ?cursor. Renvoie le nom, le slug, la région, lat/long, URL du logo, sommaire, et le nombre de programmes de l'organisation.
Auth : tout palier · Débit : 60/min bêta, 600/min stable · ETag pris en charge
GET/organizations/{slug}
Vue détaillée d'une organisation. Inclut la description complète, les coordonnées, l'URL d'inscription, la liste des programmes (sommaire) et les événements affichés.
Auth : tout palier · Débit : 60/min bêta · Cache-Control : public, max-age=300
GET/programs
Liste les programmes pour toutes les organisations. Filtres : age_band (moins de 5 ans, 5-7, 8-10, 11-13, 14-16, 17+), type (robotique, code, sciences, fabrication, IA, etc.), region, format (présentiel, virtuel, hybride), distance_km + near (lat,long). Renvoie le sommaire du programme et le slug de l'organisation parente.
Auth : tout palier · Débit : 60/min bêta · Prend en charge ?lang=fr pour les descriptions traduites, lorsqu'elles existent
GET/programs/{slug}
Vue détaillée d'un programme. Inclut l'horaire, le lieu, la tranche d'âge, le nom des animateurs (si public), le lien d'inscription, et le nombre de programmes connexes de la même organisation.
Auth : tout palier · Débit : 60/min bêta
GET/events
Événements publics à venir, toutes organisations confondues. Filtres : start_after, start_before, region, age_band, category. Prend en charge format=icalendar pour obtenir un flux .ics au lieu du JSON.
Auth : tout palier · Débit : 60/min bêta · Le format iCalendar reflète events.ics
GET/projects
Galerie de projets publics — projets soumis par les jeunes, approuvés par modération, provenant des organisations membres. Renvoie le titre, le résumé, l'URL de l'image, l'organisation contributrice, les étiquettes et la date de soumission. Aucune donnée personnelle sur les jeunes.
Auth : tout palier · Débit : 60/min bêta · phase ultérieure
GET/sponsors
Liste des commanditaires, si un programme public de commandite existe d'ici là — avec l'URL du logo, le niveau de commandite, et (lorsque le commanditaire l'autorise) une description publique. Exclut tout commanditaire qui refuse la mention publique.
Auth : tout palier · Débit : 60/min bêta · phase ultérieure
POST/organizations/{slug}/programs
Crée ou met à jour un programme appartenant à votre organisation. Requiert un jeton d'accès OAuth 2.0 avec la portée programs:write, délivré à un administrateur d'organisation vérifié.
Auth : OAuth 2.0 (portée organisation) · Débit : 30/min · phase ultérieure