Errori

Gli errori della Client API usano lo schema documentato nel Riferimento API. Gestisci sempre lo status HTTP e il code leggibile dalla macchina; conserva il messaggio testuale solo per la diagnostica.

{
  "success": false,
  "message": "Assistant not found",
  "requestId": "00000000-0000-4000-8000-000000000000",
  "errors": [{
    "code": "ASSISTANT_NOT_FOUND",
    "message": "Assistant not found"
  }]
}

Status	Significato	Azione client
400	Input non valido	Correggi la richiesta prima di ritentare.
401	Credenziale mancante o non valida	Verifica la chiave del servizio chiamato.
404	Risorsa inesistente	Verifica ID e contesto account.
409	Lo stato attuale blocca l’operazione	Leggi il codice e risolvi il conflitto.
429	Limite Client API raggiunto	Attendi Retry-After, poi riprova.
5xx	Errore del servizio	Riprova con backoff esponenziale limitato.

Il servizio Public RAG usa un formato errore proprio e più semplice. Usa solo gli status dichiarati per la specifica operazione nel Reference.