Kļūdu atsauce

Visas qr3.app API kļūdas atbilst RFC 7807 Problem Details ar Content-Type: application/problem+json.

{
  "type": "https://docs.qr3.app/errors/not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "QR code qr_xxx not found"
}

`errors/validation`

HTTP 422 Unprocessable Entity

Ievades dati neizturēja shēmas validāciju. Atbilde satur errors masīvu ar detalizētu informāciju par katru lauku.

{
  "type": "https://docs.qr3.app/errors/validation",
  "title": "Validation Error",
  "status": 422,
  "detail": "Request body validation failed",
  "errors": [
    { "field": "url", "message": "Invalid URL format" }
  ]
}

Cēloņi: Trūkstoši obligātie lauki, nepareizi datu tipi, vērtības ārpus atļautā diapazona, nederīgs URL formāts.

`errors/bad-request`

HTTP 400 Bad Request

Pamatteksts nav derīgs JSON, lai gan ir iestatīts Content-Type: application/json (piemēram, komats aiz pēdējā elementa, nepabeigts vai tukšs pamatteksts).

`errors/authentication`

HTTP 401 Unauthorized

API atslēga trūkst, ir nepareizi formatēta, beidzies tās derīguma termiņš vai tā ir anulēta.

Risinājums: Pārbaudiet, vai ir norādīta Authorization: Bearer qr3_sk_... galvene un vai atslēga ir aktīva.

`errors/unauthorized`

HTTP 401 Unauthorized

Ienākošais webhook (POST /v1/webhooks/clerk, POST /v1/webhooks/eu-registry) tika izsaukts bez derīga paraksta vai slepenās atslēgas. Ja trūkst API atslēgas vai tā ir nederīga, tā vietā tiek atgriezta errors/authentication kļūda.

`errors/authorization`

HTTP 403 Forbidden

API atslēga ir derīga, taču tai nav nepieciešamā apgabala (Scope) vai vajadzīgo tiesību.

`errors/forbidden`

HTTP 403 Forbidden

Resurss eksistē, taču tas pieder citai darbvietai vai citai organizācijai.

`errors/document-immutable`

HTTP 403 Forbidden

DPP dokumentu, kas augšupielādēts ar is_immutable, nevar dzēst.

`errors/not-found`

HTTP 404 Not Found

Pieprasītais resurss neeksistē vai ir dzēsts.

`errors/conflict`

HTTP 409 Conflict

Resurss ar tādu pašu unikālo identifikatoru jau eksistē (piemēram, dublēts slug vai Idempotency-Key kolīzija).

`errors/subscription-exists`

HTTP 409 Conflict

Tika izsaukts POST /v1/billing/checkout, lai gan organizācijai jau ir abonements. Tā vietā mainiet plānu norēķinu portālā.

`errors/rate-limited`

HTTP 429 Too Many Requests

Ir pārsniegts API atslēgas minūtes Rate-Limit. Atbilde satur Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining un X-RateLimit-Reset galvenes.

`errors/rate-limit`

HTTP 429 Too Many Requests

Ir pārsniegts resursam specifisks Rate-Limit (piemēram, 200 QR kodi dienā vienai darbvietai).

`errors/plan-limit`

HTTP 422 Unprocessable Entity

Jūsu pašreizējais plāns neatļauj šo darbību (piemēram, izsmelta DPP vai dinamisko kodu kvota, pakete ir pārāk liela, pārāk daudz darba vižu vai komandas biedru). Nepieciešams plāna uzlabojums.

`errors/invalid-file-type`

HTTP 400 Bad Request

Augšupielādētajam failam ir tips, ko galapunkts nepieņem, vai arī tā saturs neatbilst deklarētajam Content-Type.

`errors/file-too-large`

HTTP 413 Payload Too Large

Augšupielādētais fails pārsniedz plāna vai galapunkta izmēra limitu.

`errors/storage-limit-exceeded`

HTTP 422 Unprocessable Entity

Augšupielāde pārsniegtu darba vides vai DPP kopējo krātuves apjomu.

`errors/not-configured`

HTTP 503 Service Unavailable

Trūkst nepieciešamā pakalpojuma vai konfigurācijas (piemēram, nav konfigurēts Stripe, nav iestatīta Web Risk API atslēga).

`errors/unsafe-url`

HTTP 422 Unprocessable Entity

URL tika noraidīts, jo Google Web Risk to klasificēja kā nedrošu (ļaunprogrammatūra, pikšķerēšana, sociālā inženierija).

`errors/url-flagged`

HTTP 422 Unprocessable Entity

Rezervēts URL, kas periodiskas atkārtotas skenēšanas laikā vēlāk tika klasificēti kā nedroši.

`errors/already-submitted`

HTTP 409 Conflict

Dubults iesniegums — piemēram, šai darbvietai šomēnes jau ir iesniegts NPS vērtējums.

`errors/unprocessable-entity`

HTTP 422 Unprocessable Entity

Administratora darbība nav atļauta (piemēram, uzdošanās par citu superadmin). Šo veidu atgriež tikai superadmin galapunkti.

`errors/request-error`

HTTP 4xx Client Error

Rezerves kļūda klienta kļūdām bez specifiskāka veida; statuss ir norādīts atbildē. API pašlaik nav neviena zināma ceļa, kas to atgrieztu.

`errors/internal`

HTTP 500 Internal Server Error

Negaidīta kļūda serverī. Lūdzu, atkārtojiet pieprasījumu. Ja problēma joprojām pastāv: [email protected].