Autenticazione API

Come autenticarsi con l’API di Apollo utilizzando i token JWT di Supabase.

​

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.