Codici di errore

Gestito da: Team Aether365 Destinatari: Sviluppatori e amministratori IT Ambito: Riferimento completo dei codici di errore API di Aether365

Tutti gli errori API restituiscono una struttura JSON coerente:

{
  "success": false,
  "error": {
    "code": "SNAKE_CASE_ERROR_CODE",
    "message": "Human-readable description",
    "details": {}
  }
}

Autenticazione

Codice	HTTP	Significato	Soluzione
AUTH_MISSING_TOKEN	401	Nessun header Authorization nella richiesta	Includi Authorization: Bearer <token> in ogni richiesta
AUTH_INVALID_TOKEN	401	Il JWT non ha superato la verifica	Verifica che il token non sia malformato o troncato
AUTH_EXPIRED_TOKEN	401	Il JWT è scaduto	Ottieni un nuovo token effettuando nuovamente l'accesso o aggiornando la sessione
AUTH_INSUFFICIENT_SCOPE	403	L'account autenticato non ha i permessi per questa azione	Verifica di utilizzare un account con il ruolo richiesto

Autorizzazione

Codice	HTTP	Significato	Soluzione
TENANT_ACCESS_DENIED	403	La richiesta ha tentato di accedere ai dati di un altro tenant	Questo non dovrebbe verificarsi in condizioni normali - contatta il supporto se lo riscontri
AUTH_INSUFFICIENT_SCOPE	403	Permessi insufficienti per questa azione	Verifica di utilizzare un account con il ruolo richiesto

Tenant

Codice	HTTP	Significato	Soluzione
TENANT_NOT_FOUND	404	Nessun account tenant esistente per questo utente	Crea un account su app.aether365.io
TENANT_NOT_CONNECTED	400	Il consenso admin di Microsoft 365 non è stato completato	Connetti un tenant tramite Impostazioni > Connessioni

Scansioni

Codice	HTTP	Significato	Soluzione
SCAN_NOT_FOUND	404	L'ID scansione non esiste o appartiene a un altro tenant	Verifica l'ID della scansione
SCAN_ALREADY_RUNNING	409	Una scansione è già in corso per questo tenant	Attendi il completamento della scansione in corso
SCAN_PLAN_LIMIT_REACHED	429	Quota scansioni esaurita	Attendi il prossimo periodo di fatturazione o contatta il supporto
SERVICE_UNAVAILABLE	503	La piattaforma è in modalità manutenzione	Controlla lo stato e riprova al termine della manutenzione

Connessioni

Codice	HTTP	Significato	Soluzione
CONNECTION_NOT_FOUND	404	L'ID connessione non esiste	Verifica l'ID della connessione
CANNOT_REMOVE_LAST_CONNECTION	409	Impossibile rimuovere l'unica connessione rimasta	Aggiungi un'altra connessione prima di rimuovere questa

Membri del team

Codice	HTTP	Significato	Soluzione
MEMBER_LIMIT_REACHED	429	Limite membri raggiunto	Contatta il supporto per aggiungere altri membri
MEMBER_ALREADY_EXISTS	409	L'email ha già un invito attivo o in sospeso	Controlla l'elenco dei membri attuali

Scansioni pianificate

Codice	HTTP	Significato	Soluzione
SCAN_PLAN_LIMIT_REACHED	429	Limite pianificazioni personalizzate raggiunto	Elimina una pianificazione esistente o contatta il supporto

Validazione

Codice	HTTP	Significato
VALIDATION_ERROR	400	Il corpo della richiesta o un parametro di query non è valido. Il campo details elenca i campi specifici non validi.

Errori del server

Codice	HTTP	Significato	Soluzione
INTERNAL_ERROR	500	Errore del server imprevisto	Riprova la richiesta. Se l'errore persiste, contatta il supporto indicando l'ID della richiesta presente negli header di risposta.

Limiti di frequenza

Quando si superano i limiti di frequenza dell'API, l'API restituisce:

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Retry after 60 seconds."
  }
}

Stato HTTP: 429 Too Many Requests Header: Retry-After: 60

Limiti di frequenza attuali: 120 richieste al minuto per chiave API.