Ongamecloud
Connexion Démarrer
Documentation Authentification

Authentification API

L'API REST Ongamecloud te permet de piloter tes serveurs par programmation. Elle utilise une authentification par Bearer token.

Générer un token

  • Connecte-toi à ton dashboard
  • Va dans Paramètres → API
  • Clique sur Générer un token
  • Copie et conserve le token — il ne sera plus affiché ensuite

Utiliser le token

Inclus le token dans chaque requête via le header Authorization :

bash
Authorization: Bearer ogc_live_xxxxxxxxxxxxxxxx

Exemple — Lister tes serveurs

bash
curl https://api.ongamecloud.com/v1/servers \
  -H "Authorization: Bearer ogc_live_xxxxxxxxxxxxxxxx"

Exemple — Redémarrer un serveur

bash
curl -X POST https://api.ongamecloud.com/v1/servers/srv_8f2a/restart \
  -H "Authorization: Bearer ogc_live_xxxxxxxxxxxxxxxx"

Codes d'erreur

Rate limiting

L'API est limitée à 120 requêtes par minute par token. Dépasser cette limite retourne un code 429.

CodeSignification
401Token manquant ou invalide
403Accès non autorisé à cette ressource
404Ressource introuvable
429Trop de requêtes (rate limit)
500Erreur serveur