Kļūdu kodi

Uztur: Aether365 komanda Auditorija: Izstrādātāji un IT administratori Tvērums: Pilna Aether365 API kļūdu kodu atsauce

Visas API kļūdas atgriež konsekventu JSON struktūru:

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

Autentifikācija

Kods	HTTP	Nozīme	Risinājums
AUTH_MISSING_TOKEN	401	Pieprasījumā nav Authorization galvenes	Iekļaujiet Authorization: Bearer <token> katrā pieprasījumā
AUTH_INVALID_TOKEN	401	JWT nevarēja verificēt	Pārbaudiet, vai marķieris nav bojāts vai apgriezts
AUTH_EXPIRED_TOKEN	401	JWT derīgums beidzies	Iegūstiet jaunu marķieri, piesakoties vēlreiz vai atjaunojot sesiju
AUTH_INSUFFICIENT_SCOPE	403	Autentificētajam kontam nav atļaujas šai darbībai	Pārbaudiet, vai izmantojat kontu ar nepieciešamo lomu

Autorizācija

Kods	HTTP	Nozīme	Risinājums
TENANT_ACCESS_DENIED	403	Pieprasījums mēģināja piekļūt cita nomnieka datiem	Normālā lietošanā tam nekad nevajadzētu notikt - sazinieties ar atbalstu, ja to redzat
AUTH_INSUFFICIENT_SCOPE	403	Nepietiekamas atļaujas šai darbībai	Pārbaudiet, vai izmantojat kontu ar nepieciešamo lomu

Nomnieks

Kods	HTTP	Nozīme	Risinājums
TENANT_NOT_FOUND	404	Šim lietotājam nav nomnieka konta	Izveidojiet kontu vietnē app.aether365.io
TENANT_NOT_CONNECTED	400	Microsoft 365 administratora piekrišana nav pabeigta	Savienojiet nomnieku, izmantojot Iestatījumi > Savienojumi

Skenēšanas

Kods	HTTP	Nozīme	Risinājums
SCAN_NOT_FOUND	404	Skenēšanas ID neeksistē vai pieder citam nomniekam	Pārbaudiet skenēšanas ID
SCAN_ALREADY_RUNNING	409	Šim nomniekam jau notiek skenēšana	Pagaidiet, līdz pašreizējā skenēšana ir pabeigta
SCAN_PLAN_LIMIT_REACHED	429	Skenēšanas kvota izsmelta	Pagaidiet līdz nākamajam norēķinu periodam vai sazinieties ar atbalstu
SERVICE_UNAVAILABLE	503	Platforma ir apkopes režīmā	Pārbaudiet statusu un mēģiniet vēlreiz, kad apkope beigsies

Savienojumi

Kods	HTTP	Nozīme	Risinājums
CONNECTION_NOT_FOUND	404	Savienojuma ID neeksistē	Pārbaudiet savienojuma ID
CANNOT_REMOVE_LAST_CONNECTION	409	Nevar noņemt vienīgo atlikušo savienojumu	Pirms šī noņemšanas pievienojiet citu savienojumu

Komandas dalībnieki

Kods	HTTP	Nozīme	Risinājums
MEMBER_LIMIT_REACHED	429	Sasniegts dalībnieku limits	Sazinieties ar atbalstu, lai pievienotu vairāk dalībnieku
MEMBER_ALREADY_EXISTS	409	E-pastam jau ir aktīvs vai gaidošs uzaicinājums	Pārbaudiet pašreizējo dalībnieku sarakstu

Plānotās skenēšanas

Kods	HTTP	Nozīme	Risinājums
SCAN_PLAN_LIMIT_REACHED	429	Sasniegts pielāgota grafika limits	Izdzēsiet esošu grafiku vai sazinieties ar atbalstu

Validācija

Kods	HTTP	Nozīme
VALIDATION_ERROR	400	Pieprasījuma pamatteksts vai vaicājuma parametrs ir nederīgs. Lauks details uzskaita konkrētos nederīgos laukus.

Servera kļūdas

Kods	HTTP	Nozīme	Risinājums
INTERNAL_ERROR	500	Negaidīta servera kļūda	Atkārtojiet pieprasījumu. Ja kļūda saglabājas, sazinieties ar atbalstu, norādot pieprasījuma ID no atbildes galvenēm.

Pieprasījumu limiti

Kad pārsniedzat API pieprasījumu limitu, API atgriež:

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

HTTP statuss: 429 Too Many Requests Galvene: Retry-After: 60

Pašreizējie pieprasījumu limiti: 120 pieprasījumi minūtē uz vienu API atslēgu.