Autentificare API

API-ul Rivya folosește chei API pentru acces între servere.

O cheie API nu este același lucru cu o sesiune de autentificare în browser. Nu folosi cookie-uri, starea sesiunii Better Auth sau un token personal din browser drept credențială pentru API-ul public.

Formatul antetului

Trimite cheia în antetul Authorization:

Authorization: Bearer rvya_sk_...

Cheia completă este afișată o singură dată, la creare. Rivya stochează un hash și un prefix vizibil, nu secretul complet.

Creează o cheie

1. Autentifică-te în Rivya.

2. Deschide setările pentru chei API.

3. Creează o cheie cu permisiunile de care ai nevoie.

4. Copiază imediat cheia completă.

5. Stocheaz-o într-un manager de secrete de pe server sau într-o variabilă de mediu.

Nu include cheia în cod JavaScript rulat în browser, pachete de aplicații mobile, depozite publice, evenimente de analiză sau jurnale.

Permisiuni disponibile

Versiunea actuală documentează următoarele permisiuni:

• models:read

• generations:create

• generations:read

• files:create

• files:read

• credits:read

• webhooks:manage

• chat:create

• chat:read

Cheile noi create în setări includ implicit permisiunile documentate. Cheile mai vechi pot necesita recreare înainte de a folosi Files API, API Webhooks sau Chat API.

Revocare și rotație

Dacă o cheie este expusă:

1. Revocă cheia veche din setări.

2. Creează o cheie nouă.

3. Actualizează secretul pe server.

4. Confirmă că noua cheie funcționează cu GET /api/v1/credits.

5. Elimină cheia veche din sistemele de compilare, jurnale și variabilele de implementare.

Cheile revocate returnează api_key_revoked.

Erori de autentificare

Erori comune de autentificare:

• api_key_missing

• api_key_invalid

• api_key_revoked

• api_key_expired

• api_scope_denied

• public_api_disabled

Consultă Erori și limite API pentru tabelul complet al erorilor publice.

Pagini asociate

• Pornire rapidă API

• Credite API

• Erori și limite API

• Autentificare și acces în Rivya