Nordvec Docs

Fejl og hastighedsgrænser

Den ene fejlkuvert, som hvert fejlslagent request returnerer, hastighedsgrænse-headers og hvordan du genforsøger en skrivning sikkert.

Denne vejledning er maskinoversat fra den engelske original og er ikke gennemgået af en person. Den engelske version er den gældende. Oversættelse: AI‑behandling i Frankrig. Læs den engelske original
  • Vis som Markdown
  • Vis kontekstpakke

Eksterne assistenter

Disse åbner en tredjeparts AI‑tjeneste uden for EU. Linket sender adressen på denne side, og alt, hvad du spørger om der, behandles af udbyderen under deres egne vilkår.

Hvert endpoint fejler på samme måde, så en klient håndterer fejl, rategrænser og genforsøg én gang og genbruger den kode overalt, herunder over MCP.

Fejlkapslen

Ethvert ikke-2xx-svar er ét JSON-objekt:

{
  "defined": false,
  "code": "TOO_MANY_REQUESTS",
  "message": "Too many requests",
  "data": { "reason": "rate_limit.exceeded", "retryAfterMs": 12000 }
}
  • code er fejlen på HTTP-niveau, for eksempel UNAUTHORIZED, FORBIDDEN, NOT_FOUND, BAD_REQUEST eller TOO_MANY_REQUESTS.
  • data.reason, når den er til stede, er en mere præcis maskinlæsbar årsag som auth.key_not_found eller rate_limit.exceeded. Forgrén på den i stedet for på message, som er til mennesker og kan ændre sig.
  • defined er true, når operationen oplister den fejl i API-referencen, og false for fejl, som enhver anmodning kan møde (autentificering, rategrænser, en ukendt rute).
  • Et valideringsfejl svarer med BAD_REQUEST og problemerne i data.formErrors og data.fieldErrors.

Hvert svar indeholder også et X-Request-ID. Citér det, når du kontakter support, så kan vi finde den præcise anmodning.

Almindelige statuskoder

StatusKodeHvad du skal gøre
400BAD_REQUESTRet anmodningen; data.fieldErrors angiver felterne
401UNAUTHORIZEDSend en gyldig nøgle eller session
403FORBIDDENNøglen mangler det scope eller den rolle, som operationen kræver
404NOT_FOUNDRessourcen findes ikke, eller du har ikke adgang til at se den
409CONFLICTEn duplikat-skrivning er stadig i gang; prøv igen om kort tid
413PAYLOAD_TOO_LARGEAnmodningsbrød er over 1 MB; del en bulk-push op i mindre batches
422UNPROCESSABLE_CONTENTAnmodningen er velformet, men kan ikke anvendes
429TOO_MANY_REQUESTSVent i Retry-After, og prøv derefter igen

Rategrænser

Hvert svar angiver den grænse, som det blev talt op imod, i to former:

  • X-RateLimit-*-headere;
  • de IETF-strukturerede felter RateLimit (live-tilstand: r er de resterende anmodninger, t er sekunderne, indtil vinduet nulstilles) og RateLimit-Policy (kvotaen: q er grænsen, w er vinduet i sekunder).

Et 429 medfører også Retry-After i sekunder og data.retryAfterMs. Vent mindst så længe, før du sender den næste anmodning; et tidligere genforsøg tælles med og afvises igen.

Sikker genafsendelse af skrivninger

En skrivningsoperation, der oplister en Idempotency-Key-header i API-referencen, kan genafsendes uden at udføre arbejdet to gange. Send én nøgle per logisk skrivning, og gentag den samme nøgle ved hvert genforsøg:

  • den samme nøgle med det samme brød inden for 24 timer afspiller det gemte svar;
  • den samme nøgle med et andet brød afvises med 422;
  • en duplikat, der ankommer, mens den første stadig kører, får 409.

En operation uden headeren er ikke idempotent, så genafsend den kun, når du ved, at det første forsøg ikke blev gennemført.

Var denne side nyttig?

Godkendelse

Godkend API-forespørgsler med en arbejdsområde-API-nøgle sendt som en bearer-token, og vælg den nøgleklasse og de scopes, som et job har brug for.

MCP

Tilslut en AI-agent til dit arbejdsområdes vidensbase via Model Context Protocol med en API-nøgle.

På denne side

FejlkapslenAlmindelige statuskoderRategrænserSikker genafsendelse af skrivninger