Felreferens

Alla qr3.app API-fel följer RFC 7807 Problem Details med 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

Indatata klarade inte schemavalideringen. Svaret innehåller en errors-array med detaljer på fältnivå.

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

Orsaker: Obligatoriska fält saknas, felaktiga datatyper, värden utanför det tillåtna intervallet, ogiltigt URL-format.

`errors/bad-request`

HTTP 400 Bad Request

Body är inte giltig JSON trots att Content-Type: application/json är satt (t.ex. ett avslutande kommatecken, en trunkerad eller en tom body).

`errors/authentication`

HTTP 401 Unauthorized

API-nyckeln saknas, är felaktigt formaterad, har löpt ut eller har återkallats.

Lösning: Kontrollera att headern Authorization: Bearer qr3_sk_... finns och att nyckeln är aktiv.

`errors/unauthorized`

HTTP 401 Unauthorized

En inkommande webhook (POST /v1/webhooks/clerk, POST /v1/webhooks/eu-registry) anropades utan en giltig signatur eller hemlighet. En saknad eller ogiltig API-nyckel svarar istället med errors/authentication.

`errors/authorization`

HTTP 403 Forbidden

API-nyckeln är giltig, men har inte det omfång (scope) eller de behörigheter som krävs.

`errors/forbidden`

HTTP 403 Forbidden

Resursen existerar, men tillhör en annan workspace eller en annan organisation.

`errors/document-immutable`

HTTP 403 Forbidden

Ett DPP-dokument som laddats upp med is_immutable kan inte tas bort.

`errors/not-found`

HTTP 404 Not Found

Den begärda resursen finns inte eller har raderats.

`errors/conflict`

HTTP 409 Conflict

En resurs med samma unika identifierare finns redan (t.ex. duplicerad slug eller kollision med Idempotency-Key).

`errors/subscription-exists`

HTTP 409 Conflict

POST /v1/billing/checkout anropades trots att organisationen redan har ett abonnemang. Ändra planen i faktureringsportalen istället.

`errors/rate-limited`

HTTP 429 Too Many Requests

API-nyckelns hastighetsgräns (rate limit) per minut har överskridits. Svaret innehåller headers för Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining och X-RateLimit-Reset.

`errors/rate-limit`

HTTP 429 Too Many Requests

En resursspecifik hastighetsgräns har överskridits (t.ex. 200 QR-koder per dag per workspace).

`errors/plan-limit`

HTTP 422 Unprocessable Entity

Din nuvarande plan tillåter inte denna åtgärd (t.ex. kvoten för DPP:er eller dynamiska koder är förbrukad, batchen är för stor, för många workspaces eller teammedlemmar). Uppgradering krävs.

`errors/invalid-file-type`

HTTP 400 Bad Request

Den uppladdade filen har en typ som slutpunkten inte accepterar, eller så matchar dess innehåll inte den angivna Content-Type.

`errors/file-too-large`

HTTP 413 Payload Too Large

Den uppladdade filen överskrider storleksgränsen för planen eller för slutpunkten.

`errors/storage-limit-exceeded`

HTTP 422 Unprocessable Entity

Uppladdningen skulle överskrida det totala lagringsutrymmet för workspacet eller för DPP:n.

`errors/not-configured`

HTTP 503 Service Unavailable

En nödvändig tjänst eller konfiguration saknas (t.ex. Stripe är inte konfigurerat, API-nyckel för Web Risk är inte angiven).

`errors/unsafe-url`

HTTP 422 Unprocessable Entity

URL:en avvisades eftersom den har klassificerats som osäker av Google Web Risk (skadlig kod, nätfiske, social engineering).

`errors/url-flagged`

HTTP 422 Unprocessable Entity

Reserverat för URL:er som i efterhand har klassificerats som osäkra vid den periodiska återscanningen.

`errors/already-submitted`

HTTP 409 Conflict

Dubblettinskick — t.ex. har en NPS-poäng redan skickats in för denna workspace den här månaden.

`errors/unprocessable-entity`

HTTP 422 Unprocessable Entity

En admin-åtgärd är inte tillåten (t.ex. impersonering av en annan superadmin). Endast superadmin-slutpunkterna returnerar denna typ.

`errors/request-error`

HTTP 4xx Client Error

Fallback för klientfel utan en mer specifik typ; statusen finns i svaret. API:et har för närvarande ingen känd sökväg som returnerar den.

`errors/internal`

HTTP 500 Internal Server Error

Ett oväntat fel uppstod på servern. Vänligen försök igen. Vid ihållande problem: [email protected].