Référence des erreurs

Toutes les erreurs de l’API qr3.app suivent la spécification RFC 7807 Problem Details avec le header Content-Type: application/problem+json.

{
  "type": "https://docs.qr3.app/errors/not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "QR code qr_xxx not found"
}

`errors/validation`

HTTP 422 Unprocessable Entity

Les données d’entrée ont échoué à la validation du schéma. La réponse contient un tableau errors avec des détails précis par champ.

{
  "type": "https://docs.qr3.app/errors/validation",
  "title": "Validation Error",
  "status": 422,
  "detail": "Request body validation failed",
  "errors": [
    { "field": "url", "message": "Invalid URL format" }
  ]
}

Causes : Champs obligatoires manquants, types de données incorrects, valeurs hors limites, format d’URL invalide.

`errors/authentication`

HTTP 401 Unauthorized

La clé API est manquante, mal formatée, expirée ou révoquée.

Correction : Vérifiez que l’en-tête Authorization: Bearer qr3_sk_... est présent et que la clé est active.

`errors/authorization`

HTTP 403 Forbidden

La clé API est valide, mais ne possède pas le scope requis ou les permissions nécessaires.

`errors/forbidden`

HTTP 403 Forbidden

La ressource existe, mais appartient à un autre Workspace ou à une autre organisation.

`errors/not-found`

HTTP 404 Not Found

La ressource demandée n’existe pas ou a été supprimée.

`errors/conflict`

HTTP 409 Conflict

Une ressource avec le même identifiant unique existe déjà (par exemple, un slug en double ou une collision d’Idempotency-Key).

`errors/rate-limited`

HTTP 429 Too Many Requests

La limite de requêtes par minute de la clé API a été dépassée. La réponse contient les en-têtes Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset.

`errors/rate-limit`

HTTP 429 Too Many Requests

Une limite de requêtes spécifique à la ressource a été dépassée (par exemple, 200 codes QR par jour et par Workspace).

`errors/plan-limit`

HTTP 429 Too Many Requests

Le forfait actuel ne permet pas cette action (par exemple, trop de Workspaces). Mise à niveau requise.

`errors/not-configured`

HTTP 503 Service Unavailable

Un service ou une configuration requis est manquant (par exemple, Stripe non configuré, clé API Web Risk non définie).

`errors/unsafe-url`

HTTP 422 Unprocessable Entity

L’URL a été rejetée car elle a été classée comme dangereuse par Google Web Risk (malware, phishing, ingénierie sociale).

`errors/url-flagged`

HTTP 422 Unprocessable Entity

Réservé aux URL classées comme dangereuses ultérieurement lors de l’analyse périodique.

`errors/already-submitted`

HTTP 409 Conflict

Soumission en double — par exemple, un score NPS a déjà été soumis pour ce Workspace ce mois-ci.

`errors/internal`

HTTP 500 Internal Server Error

Une erreur inattendue est survenue sur le serveur. Veuillez réessayer la requête. Si le problème persiste : [email protected].