API publique

L'API REST ecloudserv permet de gérer tes serveurs par programme : les lister, consulter leurs ressources, en créer et les piloter.

URL de base

https://api.ecloudserv.fr/api/v1

Authentification

Chaque requête doit inclure une clé d'API dans l'en-tête Authorization :

Authorization: Bearer ecl_xxxxxxxxxxxxxxxx

Scopes

  • read — consulter (compte, serveurs, ressources).
  • write — agir (créer un serveur, envoyer un signal d'alimentation).

Format

Les réponses sont en JSON. Les erreurs renvoient un code HTTP approprié et un corps { "error": "..." }.

Limites

L'API est limitée à 120 requêtes/minute par IP. Au-delà, un code 429 est renvoyé.

Voir la référence complète des endpoints.