Vai al contenuto principale

​
Autenticazione

Tutte le richieste API richiedono un token JWT di Supabase valido nell’header Authorization: 
curl -H "Authorization: Bearer <your-jwt-token>" \
  https://api.apol.dev/api/v1/agent/sessions

​
Ottenere un Token

I token si ottengono tramite Supabase Auth:
  1. Accedere tramite Supabase Auth (email/password)
  2. Ricevere l’access token e il refresh token
  3. Includere l’access token in tutte le richieste API
  4. Rinnovare i token automaticamente alla scadenza

​
Validazione del Token

Il backend valida i token utilizzando il JWT secret di Supabase. I token non validi o scaduti restituiscono: 
{
  "detail": "Invalid or expired token",
  "status_code": 401
}

​
Restrizioni sulle Funzionalità

Alcuni endpoint sono protetti da restrizioni sulle funzionalità. Se una funzionalità è disabilitata per il tuo team, l’endpoint restituisce: 
{
  "detail": "Feature not available",
  "status_code": 403
}

​
Contesto dell’Organizzazione

La maggior parte degli endpoint richiede un contesto di organizzazione, passato tramite l’header X-Organization-ID o derivato dall’organizzazione attiva dell’utente autenticato.