Referință erori

Toate erorile API qr3.app respectă RFC 7807 Problem Details cu 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

Datele de intrare nu au trecut de validarea schemei. Răspunsul conține un tablou errors cu detalii specifice fiecărui câmp.

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

Cauze: Câmpuri obligatorii lipsă, tipuri de date incorecte, valori în afara intervalului permis, format URL nevalid.

`errors/authentication`

HTTP 401 Unauthorized

Cheia API lipsește, are un format incorect, este expirată sau a fost revocată.

Rezolvare: Verificați dacă antetul Authorization: Bearer qr3_sk_... este prezent și dacă cheia este activă.

`errors/authorization`

HTTP 403 Forbidden

Cheia API este validă, dar nu are scope-ul necesar sau permisiunea necesară.

`errors/forbidden`

HTTP 403 Forbidden

Resursa există, dar aparține unui alt Workspace sau unei alte organizații.

`errors/not-found`

HTTP 404 Not Found

Resursa solicitată nu există sau a fost ștearsă.

`errors/conflict`

HTTP 409 Conflict

O resursă cu același identificator unic există deja (de exemplu, slug duplicat sau coliziune Idempotency-Key).

`errors/rate-limited`

HTTP 429 Too Many Requests

Limita de rată pe minut a cheii API a fost depășită. Răspunsul conține antetele Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining și X-RateLimit-Reset.

`errors/rate-limit`

HTTP 429 Too Many Requests

O limită de rată specifică resursei a fost depășită (de exemplu, 200 de coduri QR pe zi per Workspace).

`errors/plan-limit`

HTTP 429 Too Many Requests

Planul curent nu permite această acțiune (de exemplu, prea multe Workspace-uri). Este necesar un upgrade.

`errors/not-configured`

HTTP 503 Service Unavailable

Un serviciu necesar sau o configurație lipsește (de exemplu, Stripe nu este configurat, cheia API Web Risk nu este setată).

`errors/unsafe-url`

HTTP 422 Unprocessable Entity

Adresa URL a fost respinsă deoarece a fost clasificată ca nesigură de Google Web Risk (malware, phishing, inginerie socială).

`errors/url-flagged`

HTTP 422 Unprocessable Entity

Rezervat pentru URL-uri care au fost clasificate ulterior ca nesigure în timpul scanării periodice (re-scanare).

`errors/already-submitted`

HTTP 409 Conflict

Trimitere duplicată — de exemplu, a fost trimis deja un scor NPS pentru acest Workspace în această lună.

`errors/internal`

HTTP 500 Internal Server Error

O eroare neașteptată pe server. Vă rugăm să reîncercați cererea. În caz de probleme persistente: [email protected].