Aller au contenu
qr3.app Docs

Limite de forfait

HTTP 422 Unprocessable Entity

Votre forfait actuel ne permet pas cette action. La requête elle-même est valide, mais son exécution dépasserait une limite de votre forfait. L’API effectue une vérification avant d’écrire quoi que ce soit, de sorte que rien n’a été créé. Passez à un forfait supérieur ou libérez de l’espace, par exemple en supprimant des DPP ou des codes dynamiques dont vous n’avez plus besoin.

Déclencheurs typiques

  • Quota de DPP : POST /v1/dpp, POST /v1/dpp/batch ou POST /v1/dpp/import créeraient plus de DPP que votre forfait n’en contient. Un import ne comptabilise que ses lignes valides. Les imports volumineux s’exécutent en arrière-plan et vérifient à nouveau le quota lors de leur démarrage ; si celui-ci s’est rempli entre-temps, la tâche se termine avec le statut failed.
  • Codes dynamiques : POST /v1/codes ou POST /v1/codes/batch dépasseraient le quota de codes QR dynamiques de votre organisation.
  • Taille du lot : POST /v1/codes/batch contient plus d’éléments que votre forfait ne l’autorise par requête.
  • Lignes d’import : le fichier pour POST /v1/dpp/import contient plus de lignes de données que votre forfait ne l’autorise par requête. POST /v1/codes/import accepte au maximum 1 000 lignes pour tous les forfaits.
  • Espaces de travail et membres de l’équipe : POST /v1/workspaces ou POST /v1/members dépasseraient le nombre d’espaces de travail ou de membres de l’équipe inclus dans votre forfait.
  • Documents DPP : le forfait Free ne comprend aucun stockage de documents pour les DPP, c’est pourquoi POST /v1/dpp/:id/documents et POST /v1/dpp/:id/images y sont refusés. Sur les autres forfaits, la limite correspond au nombre maximal de documents par DPP.
  • Fichiers : POST /v1/files/upload dépasserait le nombre maximal de fichiers par code QR.
  • Registre de l’UE : POST /v1/dpp/:id/register nécessite un forfait Business, Agency ou Enterprise.

Réponse

Le cas échéant, la réponse contient les champs d’extension resource et limit : resource indique la limite concernée (dynamic_codes, batch_size, workspaces ou team_members), limit est sa valeur dans votre forfait. Pour les codes dynamiques, used indique en outre combien de codes sont déjà comptabilisés dans le quota.

{
  "type": "https://docs.qr3.app/errors/plan-limit",
  "title": "Plan Limit Reached",
  "status": 422,
  "detail": "Your plan allows a maximum of 25 dynamic QR code(s). Upgrade to create more.",
  "resource": "dynamic_codes",
  "limit": 25,
  "used": 25
}

Pas une limite de débit

Réessayer plus tard ne résoudra pas cette erreur : la limite persiste jusqu’à ce que vous passiez à un forfait supérieur ou que vous libériez de l’espace. Les limites temporaires répondent quant à elles par un code HTTP 429 : rate-limited pour la limite de 60 requêtes par minute et par clé API, rate-limit pour les limites liées aux ressources, comme la création quotidienne de codes.

← Référence des erreurs