cont.groupedata.fr — API Documentation

Authentification

Toutes les routes (sauf /status) nécessitent un header :

X-Api-Key: votre-cle-api

Ou via query string : ?api_key=votre-cle-api

GET /api/v1/status Statut de l'API (sans auth)

{ "status": "ok", "version": "1.0.0", "clients": 42 }

POST /api/v1/register Enregistrer / mettre à jour son IP

Body JSON :

{ "token": "identifiant-unique", "name": "mon-serveur" }

Réponse :

{ "success": true, "ip": "1.2.3.4", "token": "...", "last_seen": 1710000000 }

GET /api/v1/ip/:token Récupérer l'IP d'un client

{ "token": "...", "ip": "1.2.3.4", "name": "mon-serveur", "last_seen": 1710000000 }

GET /api/v1/myip Obtenir sa propre IP publique

{ "ip": "1.2.3.4" }

GET /api/v1/list Lister tous les clients

{ "count": 3, "clients": [ { "token": "...", "ip": "...", "name": "...", "last_seen": ... } ] }

DELETE /api/v1/client/:token Supprimer un client

{ "success": true }