Saltearse al contenido
qr3.app Docs

Límite de plan

HTTP 422 Unprocessable Entity

Tu plan actual no permite esta acción. La solicitud en sí es válida, pero llevarla a cabo superaría un límite de tu plan. La API realiza la comprobación antes de escribir cualquier dato, por lo que no se ha creado nada. Actualiza tu plan o libera espacio, por ejemplo, eliminando DPP o códigos dinámicos que ya no necesites.

Desencadenantes típicos

  • Cuota de DPP: POST /v1/dpp, POST /v1/dpp/batch o POST /v1/dpp/import crearían más DPP de los que incluye tu plan. Una importación solo cuenta sus filas válidas. Las importaciones grandes se ejecutan en segundo plano y vuelven a comprobar la cuota al comenzar; si esta se ha completado mientras tanto, la tarea finaliza con el estado failed.
  • Códigos dinámicos: POST /v1/codes o POST /v1/codes/batch superarían la cuota de códigos QR dinámicos de tu organización.
  • Tamaño del lote: POST /v1/codes/batch contiene más elementos de los que tu plan permite por solicitud.
  • Filas de importación: el archivo para POST /v1/dpp/import tiene más filas de datos de las que tu plan permite por solicitud. POST /v1/codes/import acepta como máximo 1.000 filas en todos los planes.
  • Espacios de trabajo y miembros del equipo: POST /v1/workspaces o POST /v1/members superarían el número de espacios de trabajo o miembros del equipo que incluye tu plan.
  • Documentos de DPP: Free no incluye almacenamiento de documentos para DPP, por lo que POST /v1/dpp/:id/documents y POST /v1/dpp/:id/images se rechazan allí. En los demás planes, el límite es el número máximo de documentos por DPP.
  • Archivos: POST /v1/files/upload superaría el número máximo de archivos por código QR.
  • Registro de la UE: POST /v1/dpp/:id/register requiere un plan Business, Agency o Enterprise.

Respuesta

Cuando corresponde, la respuesta incluye los campos de extensión resource y limit: resource indica el límite (dynamic_codes, batch_size, workspaces o team_members), y limit es su valor en tu plan. Para los códigos dinámicos, used también muestra cuántos códigos se contabilizan ya en la cuota.

{
  "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
}

No es un límite de tasa

Reintentarlo más tarde no soluciona este error: el límite se mantiene hasta que actualices tu plan o liberes espacio. Los límites temporales responden en su lugar con HTTP 429: rate-limited para el límite de 60 solicitudes por minuto por clave de API, o rate-limit para límites a nivel de recurso, como la creación diaria de códigos.

← Referencia de errores