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/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/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/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/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 429 Too Many Requests

Pašreizējais plāns nepieļauj šo darbību (piemēram, pārāk daudz darbvietu). Nepieciešams plāna jauninājums (Upgrade).

`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/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].