Κωδικοί Σφαλμάτων

Maintained by: Aether365 Team Audience: Developers and IT administrators Scope: Complete reference of Aether365 API error codes

Ολα τα σφάλματα API επιστρέφουν μια ενιαία δομή JSON:

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

Πιστοποίηση

Κωδικός	HTTP	Σημασία	Διόρθωση
AUTH_MISSING_TOKEN	401	Δεν υπάρχει header Authorization στο αίτημα	Συμπεριλάβετε Authorization: Bearer <token> σε κάθε αίτημα
AUTH_INVALID_TOKEN	401	Το JWT δεν μπόρεσε να επαληθευτεί	Ελέγξτε ότι το token δεν είναι παραμορφωμένο ή κομμένο
AUTH_EXPIRED_TOKEN	401	Το JWT έχει λήξει	Αποκτήστε νέο token συνδεόμενοι ξανά ή ανανεώνοντας τη σύνδεση
AUTH_INSUFFICIENT_SCOPE	403	Ο πιστοποιημένος λογαριασμός δεν έχει δικαίωμα για αυτή την ενέργεια	Επαληθεύστε ότι χρησιμοποιείτε λογαριασμό με τον απαιτούμενο ρόλο

Εξουσιοδότηση

Κωδικός	HTTP	Σημασία	Διόρθωση
TENANT_ACCESS_DENIED	403	Προσπάθεια πρόσβασης σε δεδομένα άλλου tenant	Δεν πρέπει να συμβαίνει σε κανονική χρήση - επικοινωνήστε με υποστήριξη αν εμφανιστεί
AUTH_INSUFFICIENT_SCOPE	403	Ανεπαρκή δικαιώματα για αυτή την ενέργεια	Επαληθεύστε ότι χρησιμοποιείτε λογαριασμό με τον απαιτούμενο ρόλο

Tenant

Κωδικός	HTTP	Σημασία	Διόρθωση
TENANT_NOT_FOUND	404	Δεν υπάρχει λογαριασμός tenant για αυτόν τον χρήστη	Δημιουργήστε λογαριασμό στο app.aether365.io
TENANT_NOT_CONNECTED	400	Η συναίνεση Microsoft 365 admin δεν ολοκληρώθηκε	Συνδέστε tenant μέσω Settings > Connections

Σαρώσεις

Κωδικός	HTTP	Σημασία	Διόρθωση
SCAN_NOT_FOUND	404	Το ID σάρωσης δεν υπάρχει ή ανήκει σε άλλο tenant	Ελέγξτε το ID σάρωσης
SCAN_ALREADY_RUNNING	409	Μια σάρωση εκτελείται ήδη για αυτό το tenant	Περιμένετε να ολοκληρωθεί η τρέχουσα σάρωση
SCAN_PLAN_LIMIT_REACHED	429	Εξαντλήθηκε η ποσόστωση σαρώσεων	Περιμένετε την επόμενη περίοδο χρέωσης ή επικοινωνήστε με υποστήριξη
SERVICE_UNAVAILABLE	503	Η πλατφόρμα βρίσκεται σε κατάσταση συντήρησης	Ελέγξτε την κατάσταση και δοκιμάστε ξανά μετά τη συντήρηση

Συνδέσεις

Κωδικός	HTTP	Σημασία	Διόρθωση
CONNECTION_NOT_FOUND	404	Το ID σύνδεσης δεν υπάρχει	Ελέγξτε το ID σύνδεσης
CANNOT_REMOVE_LAST_CONNECTION	409	Δεν είναι δυνατή η αφαίρεση της μοναδικής σύνδεσης	Προσθέστε άλλη σύνδεση πριν αφαιρέσετε αυτήν

Μέλη Ομάδας

Κωδικός	HTTP	Σημασία	Διόρθωση
MEMBER_LIMIT_REACHED	429	Ξεπεράστηκε το όριο μελών	Επικοινωνήστε με υποστήριξη για προσθήκη μελών
MEMBER_ALREADY_EXISTS	409	Το email έχει ήδη ενεργή ή εκκρεμή πρόσκληση	Ελέγξτε την τρέχουσα λίστα μελών

Προγραμματισμένες Σαρώσεις

Κωδικός	HTTP	Σημασία	Διόρθωση
SCAN_PLAN_LIMIT_REACHED	429	Ξεπεράστηκε το όριο προσαρμοσμένων προγραμμάτων	Διαγράψτε υπάρχον πρόγραμμα ή επικοινωνήστε με υποστήριξη

Επικύρωση

Κωδικός	HTTP	Σημασία
VALIDATION_ERROR	400	Μη έγκυρο σώμα αιτήματος ή παράμετρος ερωτήματος. Το πεδίο details αναφέρει τα μη έγκυρα πεδία.

Σφάλματα Διακομιστή

Κωδικός	HTTP	Σημασία	Διόρθωση
INTERNAL_ERROR	500	Μη αναμενόμενο σφάλμα διακομιστή	Επαναλάβετε το αίτημα. Αν το σφάλμα επιμένει, επικοινωνήστε με υποστήριξη με το request ID από τα headers απάντησης.

Ορια Ρυθμού

Οταν υπερβείτε το όριο ρυθμού API, το API επιστρέφει:

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

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

Τρέχοντα όρια ρυθμού: 120 αιτήματα ανά λεπτό ανά κλειδί API.