# Riferimento API: panoramica

Usa `https://api.foxora.ai` per l'account `/v1` attuale, scoperta, utilizzo e percorsi di completamento chat compatibili con OpenAI.

1. Scopri i selettori di modelli attuali con `GET /v1/models` pubblico.
2. Ottieni un token di accesso all'account Foxora tramite un accesso supportato o un flusso client.
3. Invia richieste autenticate solo da un ambiente locale o lato server affidabile.
4. Imposta timeout espliciti e conserva l'intestazione di risposta `x-request-id`.
5. Controlla lo stato del conto e dell'utilizzo dopo una richiesta controllata.

```bash
curl https://api.foxora.ai/v1/me \
  -H "Authorization: Bearer $FOXORA_ACCESS_TOKEN"
```

Non inserire token di account in bundle del browser, pacchetti mobili, repository, screenshot, prompt o log. Il API restituisce errori JSON con un codice e un messaggio; i client dovrebbero distinguere in base allo stato e al codice HTTP piuttosto che solo al testo visualizzato.

**Risultato previsto:** `/v1/me` restituisce l'account e il piano previsti, con un identificatore di richiesta disponibile per la diagnostica.
