Erreurs

Format standard

{
  "statusCode": 404,
  "message": "Automation not found or unauthorized",
  "error": "Not Found"
}

Format de validation

Quand les données envoyées sont invalides :

[
  {
    "property": "name",
    "constraints": {
      "isString": "name must be a string"
    },
    "receivedValue": 123
  }
]

Codes HTTP

Code	Signification	Causes courantes
400	Bad Request	Body invalide, validation DTO échouée
401	Unauthorized	Clé API manquante, invalide, ou expirée
403	Forbidden	Scope insuffisant pour l'endpoint
404	Not Found	Ressource inexistante ou appartenant à un autre utilisateur
409	Conflict	Automation déjà en cours d'exécution
500	Internal Server Error	Erreur serveur inattendue

Exemples

Clé API manquante

curl https://api.gurren.leandre.io/api/v1/automations

{
  "statusCode": 401,
  "message": "API Key is missing",
  "error": "Unauthorized"
}

Clé API invalide

{
  "statusCode": 401,
  "message": "Invalid API Key",
  "error": "Unauthorized"
}

Scope insuffisant

{
  "statusCode": 403,
  "message": "Insufficient permissions. Required scopes: automation:execute",
  "error": "Forbidden"
}

Automation non trouvée

{
  "statusCode": 404,
  "message": "Automation not found or unauthorized",
  "error": "Not Found"
}

Les erreurs 404 sont aussi retournées si la ressource existe mais n'appartient pas à l'utilisateur authentifié. Cela évite l'énumération de ressources.