API

Tout ce que le site affiche est disponible en JSON. Sans clé, sans inscription, gratuitement.

Points d’accès

GET /api/v1/snapshot Toute l’image d’un coup : tous les services, l’indice, la répartition par état et par catégorie.

GET /api/v1/services La liste des services. Filtres : category et status.

GET /api/v1/services/{slug} Un service : état, sa justification, vérifications et une journée de mesures.

GET /api/v1/services/{slug}/history?range=24h Disponibilité et latence dans le temps. La période vaut 24h, 7d, 30d ou 90d.

GET /api/v1/incidents Nos propres incidents. Avec active=1, seulement ceux en cours.

GET /api/v1/health L’indice de santé, celui de la page d’accueil, plus l’état de notre propre collecte.

Flux

Atom, pour les lecteurs et les bots de messagerie : tout, ou un seul service.

GET /feed/incidents.xml Tous les incidents que nous enregistrons, les plus récents d’abord.

GET /feed/services/{slug}.xml La même chose, limitée à un seul service.

Cache

Les réponses portent un ETag et vivent 15 secondes. Envoyez If-None-Match et une répétition coûte 304 au lieu du corps entier.

curl -sI https://glitchmap.com/api/v1/health | grep -i etag
curl -s -H 'If-None-Match: "..."' -o /dev/null -w '%{http_code}\n' https://glitchmap.com/api/v1/health

Limite de fréquence

120 requêtes par minute et par client. Au-delà, 429 avec Retry-After. Aucune clé ne relève ce plafond : si vous avez besoin de plus, écrivez pourquoi.

Utilisation des données

Prenez-les et construisez dessus. Un lien retour fait plaisir, mais n’est pas exigé. Gardez une chose en tête : ce sont nos mesures depuis un hôte, plus ce que les fournisseurs publient sur eux-mêmes — ni garantie, ni SLA.

La façon dont les mesures sont prises est décrite sur la page des vérifications. À propos des vérifications · [email protected]