Kezeld a Rivya API nyilvános hibakódjait, HTTP státuszértékeit, rate limitjeit, idempotenciaütközéseit és újrapróbálkozási döntéseit.

A Rivya API stabil nyilvános hibakódokat ad vissza JSON-ban. Az error.code értéket kezeld integrációs szerződésként.

Hibaforma

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

Tartsd meg a requestId értéket a logjaidban, amikor a Rivya supporttól kérsz vizsgálatot egy sikertelen API-kéréshez.

Stabil hibakódok

Kód	HTTP státusz	Jelentés	Javasolt művelet
`public_api_disabled`	503	A nyilvános API-hívások átmenetileg le vannak tiltva.	Próbáld újra később, vagy használd kézzel a Studiót.
`api_key_missing`	401	A kérés nem tartalmazott Bearer API-kulcsot.	Küldd el ezt: `Authorization: Bearer rvya_sk_...`.
`api_key_invalid`	401	A kulcs nem ellenőrizhető.	Ellenőrizd a kulcsot, és szükség esetén rotáld.
`api_key_revoked`	401	A kulcsot visszavonták a Beállításokban.	Hozz létre új kulcsot.
`api_key_expired`	401	A kulcs már nem érvényes.	Hozz létre új kulcsot.
`api_scope_denied`	403	A kulcs nem rendelkezik a szükséges scope-pal.	Hozz létre kulcsot a szükséges scope-pal.
`rate_limited`	429	Túl sok kérés érkezett az aktuális ablakban.	Lassíts, és próbáld újra később.
`validation_failed`	400	A body, modell, prompt vagy paraméterek érvénytelenek.	Hasonlítsd össze a body-t a modellreferenciával.
`not_found`	404	A kért feladat nem létezik, vagy nem a fiók tulajdona.	Ellenőrizd a nyilvános task ID-t és a fiókhatárt.
`webhook_url_rejected`	400	A webhook endpoint URL-je nem engedélyezett.	Használj HTTPS nyilvános URL-t hitelesítő adatok, fragmentek, localhost vagy privát hálózati címek nélkül.
`chat_model_not_supported`	400	A kiválasztott modell nem érhető el a Chat API számára.	Olvasd a `/api/v1/models` endpointot, és válassz elérhető chatmodellt.
`chat_session_conflict`	409	A chatmunkamenet nem használható ehhez a kéréshez.	Használj ugyanahhoz a fiókhoz és modellhez tartozó, API-val létrehozott munkamenetet.
`chat_attachment_not_supported`	400	A chat-csatolmány nem támogatott.	Tölts fel képet a Files API-n keresztül, és add át a `file_id` értékét.
`idempotency_conflict`	409	Ugyanazt az idempotenciakulcsot más bemenettel használták újra.	Használj új kulcsot, vagy küldd újra pontosan ugyanazt a body-t.
`insufficient_credits`	402	A fióknak nincs elég kreditje.	Adj hozzá krediteket, vagy válassz alacsonyabb költségű kérést.
`internal_error`	500	A kérést nem lehetett befejezni.	Próbáld újra idempotenciával, vagy fordulj a supporthoz a `requestId` értékkel.

Rate limitek

A Rivya alkalmazásszintű Public API rate limiteket alkalmaz API-kulcsonként. Az alapértelmezett éles limitet a PUBLIC_API_RATE_LIMIT_PER_MINUTE konfigurálja.

Ha rate_limited választ kapsz, használj exponenciális backoffot. Ne próbálkozz újra szoros ciklusban.

Idempotens újrapróbálkozások

Küldj Idempotency-Key headert minden éles POST /api/v1/generations és POST /api/v1/chat/completions kéréshez.

Ajánlott minta:

generálj egyedi kulcsot minden logikai generálási kéréshez
ugyanazt a kulcsot csak ugyanazon body újrapróbálásakor használd újra
tárold a visszakapott nyilvános task ID-t a saját job rekordoddal együtt
Chat API esetén tárold a visszakapott session_id értéket, ha ugyanazt a beszélgetést szeretnéd folytatni
ne használd újra ugyanazt a kulcsot más modellhez, prompthoz vagy paraméterekhez

Ha a hálózat a beküldés után hibázik, próbáld újra ugyanazzal a body-val és ugyanazzal az Idempotency-Key értékkel. A Rivya ilyenkor a tárolt nyilvános választ adhatja vissza anélkül, hogy duplikált feladatot hozna létre.

Újrapróbálkozási döntések

Ezeket próbáld újra backoffal:

public_api_disabled
rate_limited
internal_error
ideiglenes hálózati hibák

Ezeket ne próbáld újra a bemenet módosítása nélkül:

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 hibák és limitek

Hibaforma

Stabil hibakódok

Rate limitek

Idempotens újrapróbálkozások

Újrapróbálkozási döntések

Kapcsolódó oldalak

Tartalomjegyzék