Limit planu

HTTP 422 Unprocessable Entity

Twój bieżący plan nie pozwala na tę akcję. Samo żądanie jest prawidłowe, ale jego wykonanie przekroczyłoby limit Twojego planu. API sprawdza limity przed zapisaniem jakichkolwiek danych, więc nic nie zostało utworzone. Przejdź na wyższy plan lub zwolnij miejsce, na przykład usuwając DPP lub dynamiczne kody, których już nie potrzebujesz.

Typowe przyczyny

Limit DPP: POST /v1/dpp, POST /v1/dpp/batch lub POST /v1/dpp/import utworzyłoby więcej DPP, niż obejmuje Twój plan. Import zlicza tylko prawidłowe wiersze. Duże importy są uruchamiane w tle i ponownie sprawdzają limit w momencie rozpoczęcia; jeśli w międzyczasie limit został wyczerpany, zadanie zakończy się ze statusem failed.
Kody dynamiczne: POST /v1/codes lub POST /v1/codes/batch przekroczyłoby limit dynamicznych kodów QR Twojej organizacji.
Rozmiar partii (batch): POST /v1/codes/batch zawiera więcej elementów, niż Twój plan pozwala w jednym żądaniu.
Wiersze importu: plik dla POST /v1/dpp/import zawiera więcej wierszy danych, niż Twój plan pozwala w jednym żądaniu. POST /v1/codes/import akceptuje maksymalnie 1 000 wierszy w każdym planie.
Obszary robocze i członkowie zespołu: POST /v1/workspaces lub POST /v1/members przekroczyłoby liczbę obszarów roboczych (Workspaces) lub członków zespołu, które obejmuje Twój plan.
Dokumenty DPP: Plan Free nie zawiera miejsca na dokumenty dla DPP, dlatego żądania POST /v1/dpp/:id/documents i POST /v1/dpp/:id/images są w nim odrzucane. W innych planach ograniczeniem jest maksymalna liczba dokumentów na DPP.
Pliki: POST /v1/files/upload przekroczyłoby maksymalną liczbę plików na kod QR.
Rejestr UE: POST /v1/dpp/:id/register wymaga planu Business, Agency lub Enterprise.

Odpowiedź

Tam, gdzie ma to zastosowanie, odpowiedź zawiera dodatkowe pola resource i limit: resource wskazuje nazwę limitu (dynamic_codes, batch_size, workspaces lub team_members), a limit określa jego wartość w Twoim planie. W przypadku kodów dynamicznych pole used dodatkowo pokazuje, ile kodów jest już wliczanych do limitu.

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

To nie jest ograniczenie liczby żądań (rate limit)

Ponowne przesłanie żądania później nie rozwiąże tego błędu: limit pozostaje aktywny, dopóki nie przejdziesz na wyższy plan lub nie zwolnisz miejsca. Tymczasowe limity zwracają zamiast tego kod HTTP 429: rate-limited w przypadku limitu 60 żądań na minutę dla klucza API, lub rate-limit w przypadku limitów na poziomie zasobów, takich jak dzienne tworzenie kodów.

← Referencja błędów