Errors
How the API reports errors, and what each status code means.
EZQR uses HTTP status codes to say whether a request worked. Errors have a JSON body with an error message written for people, so you can show it or log it as is.
{ "error": "QR code not found" }Status codes
| Status | Meaning |
|---|---|
200 | The request worked |
201 | A resource was created |
204 | The request worked and there's nothing to return |
400 | The body or parameters are invalid, or the body isn't valid JSON |
401 | The API key is missing, wrong, revoked or expired |
403 | Your plan doesn't include this, a plan limit was reached, or your role can't do it |
404 | The resource doesn't exist in your workspace |
429 | Too many requests. See Rate limits |
500 | Something went wrong on our side. It's safe to retry |
Common errors
| Error | What to do |
|---|---|
Dynamic QR code limit reached | Delete or deactivate dynamic codes, or upgrade the plan |
A destination URL is required for dynamic QR codes | Send targetUrl, or a URL as content |
Upgrade your plan to edit this dynamic QR code | The code is beyond your plan's dynamic code limit. Upgrade to edit it again |
Folder not found | The folderId doesn't belong to your workspace |
Domain not found or not active yet | Verify the custom domain before using its domainId |
Retrying
Retry 429 and 500 responses with exponential backoff. Don't retry 400, 401, 403 or 404 without changing the request, because the result will be the same.