Développeurs
Accès JSON en lecture seule à ce que nous mesurons nous-mêmes : incidents de câbles sous-marins avec chronologies mesurées, agrégats quotidiens de latence de notre réseau de sondes distribué et statut de surveillance en direct. Sans inscription ni clé. Libre pour usage commercial et de recherche sous CC BY 4.0 : il suffit de créditer GeoCables avec un lien.
Base URL: https://geocables.com/api/v1 60 requests / min / IP Responses cached ~10 min CORS: open
curl https://geocables.com/api/v1/status
curl "https://geocables.com/api/v1/incidents?status=resolved&limit=5"
curl "https://geocables.com/api/v1/latency?from=2026-09-01&target_country=SG"| Endpoint | Ce qu'il renvoie | Paramètres |
|---|---|---|
GET /incidents | Incidents de câbles détectés : type, gravité, statut, RTT mesuré contre la référence, verdict, lien vers la page publique. Étiquetage honnête : une anomalie qui n'est pas une avarie le dit. | status (active | monitoring | warning | resolved), limit ≤ 100, offset |
GET /incidents/{alert_number} | Un incident avec sa chronologie mesurée complète (RTT par événement, ratios, descriptions). | - |
GET /latency | Agrégats quotidiens ville-sonde vers cible : nombre de mesures, médiane, p90, RTT minimal, sauts moyens. Mêmes colonnes que le jeu de données ouvert. | from, to (max 92 d), probe_city, target_city, target_country, limit ≤ 1000 |
GET /status | Résumé en direct : alertes actives, routes et mesures des dernières 24 h. | - |
GET /openapi.json | Spécification OpenAPI 3.0 lisible par machine. | - |
{
"data": [ ... ],
"meta": {
"attribution": "GeoCables (https://geocables.com), CC BY 4.0",
"docs": "https://geocables.com/developers",
"total": 180, "limit": 25, "offset": 0
}
}Tout d'un coup ? Le jeu de données ouvert fournit des instantanés quotidiens CSV/JSON (les mesures brutes sont conservées en fenêtre glissante ; les agrégats quotidiens remontent plus loin, et l'historique des versions sur Kaggle / Hugging Face conserve chaque instantané). Plutôt un abonnement ? Flux RSS des incidents.
La limite existe pour qu'un script ne chasse pas les autres. Besoin de plus (recherche, tableau de bord de rédaction, intégration) ? Écrivez à datasets@geocables.com. L'attribution avec un lien vers geocables.com est la seule exigence.