Fejlreference

Alle qr3.app API-fejl følger 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

Inputdataene bestod ikke skemavalideringen. Svaret indeholder et errors-array med feltspecifikke detaljer.

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

Årsager: Manglende obligatoriske felter, forkerte datatyper, værdier uden for det tilladte interval, ugyldigt URL-format.

`errors/bad-request`

HTTP 400 Bad Request

Bodyen er ikke gyldig JSON, selvom Content-Type: application/json er angivet (f.eks. et efterfølgende komma, en afkortet eller en tom body).

`errors/authentication`

HTTP 401 Unauthorized

API-nøglen mangler, er forkert formateret, udløbet eller tilbagekaldt.

Løsning: Kontroller, om Authorization: Bearer qr3_sk_... headeren er til stede, og om nøglen er aktiv.

`errors/unauthorized`

HTTP 401 Unauthorized

En indgående webhook (POST /v1/webhooks/clerk, POST /v1/webhooks/eu-registry) blev kaldt uden en gyldig signatur eller hemmelighed. En manglende eller ugyldig API-key svarer i stedet med errors/authentication.

`errors/authorization`

HTTP 403 Forbidden

API-nøglen er gyldig, men har ikke det påkrævede scope eller den nødvendige tilladelse.

`errors/forbidden`

HTTP 403 Forbidden

Ressourcen eksisterer, men tilhører et andet workspace eller en anden organisation.

`errors/document-immutable`

HTTP 403 Forbidden

Et DPP-dokument, der er uploadet med is_immutable, kan ikke slettes.

`errors/not-found`

HTTP 404 Not Found

Den anmodede ressource eksisterer ikke eller er blevet slettet.

`errors/conflict`

HTTP 409 Conflict

En ressource med samme unikke identifikator eksisterer allerede (f.eks. duplikeret slug eller kollision med Idempotency-Key).

`errors/subscription-exists`

HTTP 409 Conflict

POST /v1/billing/checkout blev kaldt, selvom organisationen allerede har et abonnement. Skift i stedet planen i afregningsportalen.

`errors/rate-limited`

HTTP 429 Too Many Requests

API-nøglens rate-grænse pr. minut er overskredet. Svaret indeholder headerne Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining og X-RateLimit-Reset.

`errors/rate-limit`

HTTP 429 Too Many Requests

En ressourcespecifik rate-grænse er overskredet (f.eks. 200 QR-koder pr. dag pr. workspace).

`errors/plan-limit`

HTTP 422 Unprocessable Entity

Din aktuelle plan tillader ikke denne handling (f.eks. kvote for DPP’er eller dynamiske koder opbrugt, batch for stor, for mange workspaces eller teammedlemmer). Opgradering påkrævet.

`errors/invalid-file-type`

HTTP 400 Bad Request

Den uploadede fil er af en type, som endepunktet ikke accepterer, eller dens indhold matcher ikke den angivne Content-Type.

`errors/file-too-large`

HTTP 413 Payload Too Large

Den uploadede fil overskrider størrelsesgrænsen for planen eller endepunktet.

`errors/storage-limit-exceeded`

HTTP 422 Unprocessable Entity

Uploaden ville overskride det samlede lager for dit workspace eller for din DPP.

`errors/not-configured`

HTTP 503 Service Unavailable

En påkrævet tjeneste eller konfiguration mangler (f.eks. Stripe er ikke konfigureret, Web Risk API-nøgle er ikke angivet).

`errors/unsafe-url`

HTTP 422 Unprocessable Entity

URL’en blev afvist, fordi den blev klassificeret som usikker af Google Web Risk (malware, phishing, social engineering).

`errors/url-flagged`

HTTP 422 Unprocessable Entity

Reserveret til URL’er, der efterfølgende er blevet klassificeret som usikre under den periodiske genskanning.

`errors/already-submitted`

HTTP 409 Conflict

Dobbelt indsendelse — f.eks. er der allerede indsendt en NPS-score for dette workspace i denne måned.

`errors/unprocessable-entity`

HTTP 422 Unprocessable Entity

En admin-handling er ikke tilladt (f.eks. at efterligne en anden superadmin). Kun superadmin-endepunkterne returnerer denne type.

`errors/request-error`

HTTP 4xx Client Error

Fallback for klientfejl uden en mere specifik type; statuskoden findes i svaret. API’en har i øjeblikket ingen kendt sti, der returnerer den.

`errors/internal`

HTTP 500 Internal Server Error

En uventet fejl på serveren. Gentag venligst anmodningen. Ved vedvarende problemer: [email protected].