Fejl - Floral Docs

Fejl fra det offentlige API bruger samme JSON-format:

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "Kaldet indeholder ugyldige værdier.",
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Forgren på error.code, ikke den læsbare besked. Oplys requestId, når du kontakter Floral-support.

Kode	Betydning
`UNAUTHENTICATED`	Bearer-token mangler eller er ugyldigt.
`FORBIDDEN`	Kalderen mangler det krævede scope eller adgang.
`NOT_FOUND`	Ressourcen er ikke tilgængelig for kalderen.
`FEATURE_DISABLED`	Den påkrævede Floral-funktion er slået fra.
`INVALID_INPUT`	Sti, query eller input bestod ikke valideringen.
`CONFLICT`	Den ønskede overgang strider mod den aktuelle tilstand.
`INVALID_STATE`	Ressourcens tilstand tillader ikke handlingen. Genindlæs den, før du vurderer et nyt forsøg.
`IDEMPOTENCY_CONFLICT`	Den samme idempotensnøgle er allerede brugt med andet kanonisk input til handlingen. Brug en ny nøgle til et nyt logisk kald.
`PRECONDITION_REQUIRED`	Handlingen kræver en `If-Match`-header.
`VERSION_CONFLICT`	Den sendte `ETag` er forældet. Genindlæs og afstem før et nyt forsøg.
`RATE_LIMITED`	Kalderen har overskredet den aktuelle grænse. Følg `Retry-After`.
`INTERNAL_ERROR`	Floral kunne ikke gennemføre kaldet. Prøv igen med backoff, når det er sikkert.

Request-id’er

Du kan sende en X-Request-ID-header på højst 128 tegn med bogstaver, tal, ., _, :, / og -. Floral gentager et gyldigt id i svarheaderen og fejlformatet. Ugyldige værdier erstattes med et genereret id. Opret en unik værdi pr. logisk kald, og gem den i integrationens logs.

Sikre nye forsøg

Prøv 429 og midlertidige 5xx-svar igen med eksponentielt backoff og jitter.
Prøv læsekald igen, når resultatet stadig er relevant for kalderen.
Prøv kun et skrivekald automatisk igen, når det kræver Idempotency-Key. Genbrug præcis samme nøgle, metode, sti og input.
Prøv ikke 412 VERSION_CONFLICT igen, før du har genindlæst og afstemt den aktuelle ressource.

Læs Driftssikkerhed og nye forsøg om grænser, idempotent gentagelse, optimistisk samtidighed og logning.