API v1 de Kolaboro
JSON en lecture seule sur HTTPS, sans clé pour les points d’accès ouverts, CORS ouvert à tous les sites, mis en cache en périphérie. Les identifiants sont stables : un projet garde son identifiant (BALI-014) et son slug à vie. Essayez un appel ci-dessous ; les réponses viennent directement de kolaboro.com.
Points d’accès
GET /api/v1/projectsTous les projets nommés : identifiant, slug, nom, marché
GET /api/v1/projects/{slug}Un projet : faits sourcés, dates, sources
GET /api/v1/developersToutes les pages de promoteurs
GET /api/v1/developers/{slug}Un promoteur et ses projets
GET /api/v1/developers/{slug}/websiteSites d’un promoteur : disponibilité, certificat, enregistrement du domaine
GET /api/v1/changes?since={since}Chaque changement daté depuis un instant, pour une synchronisation incrémentale
GET /api/v1/changes/feed.jsonLes 100 derniers changements en JSON Feed
GET /api/v1/projects/{slug}/certificateCertificat de vérification signé d’un projet
GET /api/v1/snapshotsChaîne de hachages quotidienne des données
GET /api/v1/data-qualityCouverture et fraîcheur par champ et par marché
GET /api/v1/search-indexIndex de recherche compact
En-têtes
Réponse
Limites et en-têtes
120 appels par minute et par adresse IP pour chaque groupe de points d’accès. Chaque réponse porte RateLimit-Policy et RateLimit (format du brouillon IETF) ainsi que les anciens X-RateLimit-Limit et X-RateLimit-Remaining. Une réponse 429 porte Retry-After. Envoyez If-None-Match avec l’ETag reçu pour obtenir 304 si rien n’a changé.