Håndter Rivya APIs offentlige fejlkoder, HTTP-statusværdier, rate limits, idempotency-konflikter og beslutninger om retry.

Rivya API returnerer stabile offentlige fejlkoder i JSON. Behandl værdien error.code som integrationskontrakten.

Fejlformat

{
  "error": {
    "code": "api_key_missing",
    "message": "A valid Bearer API key is required.",
    "requestId": "req_..."
  }
}

Gem requestId i dine logs, når du beder Rivya-support om at undersøge en fejlet API-anmodning.

Stabile fejlkoder

Code	HTTP status	Betydning	Foreslået handling
`public_api_disabled`	503	Public API-kald er midlertidigt deaktiveret.	Prøv igen senere, eller brug Studio manuelt.
`api_key_missing`	401	Anmodningen inkluderede ikke en Bearer API-nøgle.	Send `Authorization: Bearer rvya_sk_...`.
`api_key_invalid`	401	Nøglen kan ikke verificeres.	Kontroller nøglen, og rotér den om nødvendigt.
`api_key_revoked`	401	Nøglen blev tilbagekaldt i Settings.	Opret en ny nøgle.
`api_key_expired`	401	Nøglen er ikke længere gyldig.	Opret en ny nøgle.
`api_scope_denied`	403	Nøglen har ikke det påkrævede scope.	Opret en nøgle med det nødvendige scope.
`rate_limited`	429	For mange anmodninger i det aktuelle vindue.	Træk dig tilbage, og prøv igen senere.
`validation_failed`	400	Body, model, prompt eller params er ugyldige.	Sammenlign din body med modelreferencen.
`not_found`	404	Den ønskede opgave findes ikke eller ejes ikke af kontoen.	Kontroller det offentlige task-ID og kontogrænsen.
`webhook_url_rejected`	400	Webhook-endpoint-URL'en er ikke tilladt.	Brug en offentlig HTTPS-URL uden credentials, fragments, localhost eller private netværksadresser.
`chat_model_not_supported`	400	Den valgte model er ikke tilgængelig for Chat API.	Læs `/api/v1/models`, og vælg en tilgængelig chatmodel.
`chat_session_conflict`	409	Chat-sessionen kan ikke bruges til denne anmodning.	Brug en API-oprettet session, der ejes af samme konto og model.
`chat_attachment_not_supported`	400	Chat-vedhæftningen understøttes ikke.	Upload et billede via Files API, og send dets `file_id`.
`idempotency_conflict`	409	Den samme idempotency key blev genbrugt med et andet input.	Brug en ny key, eller send præcis samme body igen.
`insufficient_credits`	402	Kontoen har ikke credits nok.	Tilføj credits, eller vælg en billigere anmodning.
`internal_error`	500	Anmodningen kunne ikke gennemføres.	Prøv igen med idempotency, eller kontakt support med `requestId`.

Rate limits

Rivya anvender application-level Public API-rate limits pr. API-nøgle. Standardgrænsen i produktion konfigureres af PUBLIC_API_RATE_LIMIT_PER_MINUTE.

Når du modtager rate_limited, skal du bruge eksponentiel backoff. Prøv ikke igen i en tæt løkke.

Idempotente retries

Send Idempotency-Key med hver production-anmodning til POST /api/v1/generations og POST /api/v1/chat/completions.

Anbefalet mønster:

generér en unik key pr. logisk generationsanmodning
genbrug kun samme key, når du retryer samme body
gem det returnerede offentlige task-ID sammen med din egen jobrecord
for Chat API skal du gemme det returnerede session_id, når du vil fortsætte samme samtale
genbrug ikke én key til en anden model, prompt eller andre params

Hvis netværket fejler efter indsendelse, så retry med samme body og samme Idempotency-Key. Rivya kan returnere det gemte offentlige svar i stedet for at oprette en dubletopgave.

Retry-beslutninger

Retry disse med backoff:

public_api_disabled
rate_limited
internal_error
midlertidige netværksfejl

Retry ikke disse uden at ændre input:

api_key_invalid
api_key_revoked
api_scope_denied
validation_failed
webhook_url_rejected
chat_model_not_supported
chat_session_conflict
chat_attachment_not_supported
idempotency_conflict
insufficient_credits

API-fejl og grænser

Fejlformat

Stabile fejlkoder

Rate limits

Idempotente retries

Retry-beslutninger

Relaterede sider

Indholdsfortegnelse