Pular para o conteúdo

Limite do plano

HTTP 422 Unprocessable Entity

O seu plano atual não permite esta ação. A requisição em si é válida, mas a sua execução excederia um limite do seu plano. A API faz a verificação antes de gravar qualquer dado, portanto nada foi criado. Faça um upgrade do seu plano ou libere capacidade, por exemplo, excluindo DPPs ou códigos dinâmicos de que não precisa mais.

Gatilhos comuns

  • Cota de DPP: POST /v1/dpp, POST /v1/dpp/batch ou POST /v1/dpp/import criariam mais DPPs do que o seu plano inclui. Uma importação contabiliza apenas as suas linhas válidas. Importações grandes são executadas em segundo plano e verificam a cota novamente quando iniciam; se esta tiver sido preenchida entretanto, o trabalho termina com o status failed.
  • Códigos dinâmicos: POST /v1/codes ou POST /v1/codes/batch excederiam a cota de códigos QR dinâmicos da sua organização.
  • Tamanho do lote: POST /v1/codes/batch contém mais itens do que o seu plano permite por requisição.
  • Linhas de importação: o arquivo para POST /v1/dpp/import tem mais linhas de dados do que o seu plano permite por requisição. POST /v1/codes/import aceita no máximo 1.000 linhas em qualquer plano.
  • Workspaces e membros da equipe: POST /v1/workspaces ou POST /v1/members excederiam o número de Workspaces ou membros da equipe que o seu plano inclui.
  • Documentos de DPP: o plano Free não inclui armazenamento de documentos para DPPs, pelo que POST /v1/dpp/:id/documents e POST /v1/dpp/:id/images são recusados nesse plano. Nos outros planos, o limite é o número máximo de documentos por DPP.
  • Arquivos: POST /v1/files/upload excederia o número máximo de arquivos por código QR.
  • Registro da UE: POST /v1/dpp/:id/register requer um plano Business, Agency ou Enterprise.

Resposta

Sempre que aplicável, a resposta contém os campos adicionais resource e limit: resource indica o limite (dynamic_codes, batch_size, workspaces ou team_members), limit é o seu valor no seu plano. Para códigos dinâmicos, used também mostra quantos códigos já estão contabilizados na cota.

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

Não é um limite de taxa

Tentar novamente mais tarde não resolve este erro: o limite permanece até que faça um upgrade ou libere capacidade. Os limites temporários respondem, em vez disso, com HTTP 429: rate-limited para o limite de 60 requisições por minuto por chave de API, rate-limit para limites ao nível dos recursos, como a criação diária de códigos.

← Referência de erros