Autenticazione e chiavi API

Ogni richiesta all'API di LOCRAI è autenticata con una chiave personale, generata dalla dashboard nella sezione Chiavi API. La chiave inizia con il prefisso idp_live_ e va trattata come una password: non condividerla e non includerla nel codice client.

Inviare la chiave

Puoi passare la chiave in due modi equivalenti: nell'header Authorization come Bearer token, oppure nell'header X-Api-Key. Scegli quello più comodo per il tuo client.

curl https://app.locrai.com/api/v1/documents \
  -H "Authorization: Bearer idp_live_xxxxxxxxxxxxxxxxxxxx"

curl https://app.locrai.com/api/v1/documents \
  -H "X-Api-Key: idp_live_xxxxxxxxxxxxxxxxxxxx"

Scope e permessi

Ogni chiave ha uno o più scope: read per le richieste in lettura (GET ed export), write per creare, aggiornare e cancellare. Una chiave priva dello scope necessario riceve una risposta 403.

Errori e limiti

Una chiave mancante o non valida restituisce 401. L'API applica un limite di 120 richieste al minuto per chiave: oltre la soglia ricevi 429 e dovrai riprovare poco dopo.

{ "message": "Invalid API key." }