Autenticazione API

Rivya API usa chiavi API per l'accesso server-to-server.

Una chiave API non è la stessa cosa di una sessione di accesso nel browser. Non usare cookie, stato di sessione Better Auth o token personale del browser come credenziale API pubblica.

Formato header

Invia la chiave nell'header Authorization:

Authorization: Bearer rvya_sk_...

La chiave completa viene mostrata una sola volta al momento della creazione. Rivya conserva un hash e un prefisso visibile, non il segreto completo.

Creare una chiave

1. Accedi a Rivya.

2. Apri impostazioni API Keys.

3. Crea una chiave con gli scope necessari.

4. Copia subito la chiave completa.

5. Conservala in un secret manager lato server o in una variabile d'ambiente.

Non inserire la chiave in JavaScript lato client, bundle di app mobili, repository pubblici, eventi analytics o log.

Scope attuali

La prima versione documenta questi scope:

• models:read

• generations:create

• generations:read

• files:create

• files:read

• credits:read

• webhooks:manage

• chat:create

• chat:read

Le nuove chiavi create in Settings includono gli scope documentati per impostazione predefinita. Le chiavi più vecchie potrebbero dover essere ricreate prima di usare Files API, API Webhooks o Chat API.

Revoca e rotazione

Se una chiave viene esposta:

1. Revoca la vecchia chiave da Settings.

2. Crea una nuova chiave.

3. Aggiorna il secret lato server.

4. Conferma che la nuova chiave funzioni con GET /api/v1/credits.

5. Rimuovi la vecchia chiave da sistemi di build, log e variabili di deploy.

Le chiavi revocate restituiscono api_key_revoked.

Errori di autenticazione

Errori di autenticazione comuni:

• api_key_missing

• api_key_invalid

• api_key_revoked

• api_key_expired

• api_scope_denied

• public_api_disabled

Vedi errori e limiti API per la tabella completa degli errori pubblici.

Pagine correlate

• Quickstart API

• Crediti API

• Errori e limiti API

• Autenticazione e accesso in Rivya