Veakoodid

Haldab: Aether365 meeskond Sihtrühm: arendajad ja IT-administraatorid Ulatus: Aether365 API veakoodide täielik viide

Kõik API vead tagastavad ühtse JSON-struktuuri:

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

Autentimine

Kood	HTTP	Tähendus	Lahendus
AUTH_MISSING_TOKEN	401	Päringus puudub Authorization päis	Lisa igasse päringusse Authorization: Bearer <token>
AUTH_INVALID_TOKEN	401	JWT-d ei õnnestunud verifitseerida	Kontrolli, et token ei oleks vigane ega kärbitud
AUTH_EXPIRED_TOKEN	401	JWT on aegunud	Hangi uus token uuesti sisse logides või seanssi värskendades
AUTH_INSUFFICIENT_SCOPE	403	Autenditud kontol pole selle toimingu jaoks õigust	Veendu, et kasutad vajaliku rolliga kontot

Volitamine

Kood	HTTP	Tähendus	Lahendus
TENANT_ACCESS_DENIED	403	Päring üritas pääseda ligi teise tenanti andmetele	Tavakasutuses ei tohiks see kunagi juhtuda - kui näed seda, võta ühendust toega
AUTH_INSUFFICIENT_SCOPE	403	Selle toimingu jaoks ebapiisavad õigused	Veendu, et kasutad vajaliku rolliga kontot

Tenant

Kood	HTTP	Tähendus	Lahendus
TENANT_NOT_FOUND	404	Selle kasutaja jaoks ei ole tenanti kontot	Loo konto aadressil app.aether365.io
TENANT_NOT_CONNECTED	400	Microsoft 365 admini nõusolekut ei ole antud	Ühenda tenant jaotise Settings > Connections kaudu

Skannimised

Kood	HTTP	Tähendus	Lahendus
SCAN_NOT_FOUND	404	Skannimise ID-d ei ole olemas või kuulub teisele tenantile	Kontrolli skannimise ID-d
SCAN_ALREADY_RUNNING	409	Selle tenanti jaoks on juba skannimine pooleli	Oota, kuni praegune skannimine lõpeb
SCAN_PLAN_LIMIT_REACHED	429	Skannimise kvoot on ammendatud	Oota järgmise arveldusperioodini või võta ühendust toega
SERVICE_UNAVAILABLE	503	Platvorm on hooldusrežiimis	Kontrolli olekut ja proovi uuesti, kui hooldus lõpeb

Ühendused

Kood	HTTP	Tähendus	Lahendus
CONNECTION_NOT_FOUND	404	Ühenduse ID-d ei ole olemas	Kontrolli ühenduse ID-d
CANNOT_REMOVE_LAST_CONNECTION	409	Ainsat järelejäänud ühendust ei saa eemaldada	Lisa enne selle eemaldamist veel üks ühendus

Meeskonnaliikmed

Kood	HTTP	Tähendus	Lahendus
MEMBER_LIMIT_REACHED	429	Liikmete piir saavutatud	Võta rohkemate liikmete lisamiseks ühendust toega
MEMBER_ALREADY_EXISTS	409	E-postil on juba aktiivne või ootel kutse	Kontrolli praegust liikmete nimekirja

Ajastatud skannimised

Kood	HTTP	Tähendus	Lahendus
SCAN_PLAN_LIMIT_REACHED	429	Kohandatud ajakavade piir saavutatud	Kustuta olemasolev ajakava või võta ühendust toega

Valideerimine

Kood	HTTP	Tähendus
VALIDATION_ERROR	400	Päringu keha või päringuparameeter on vigane. Väli details loetleb konkreetsed vigased väljad.

Serveri vead

Kood	HTTP	Tähendus	Lahendus
INTERNAL_ERROR	500	Ootamatu serveriviga	Proovi päringut uuesti. Kui viga püsib, võta ühendust toega ja lisa vastuse päistest pärinev päringu ID.

Päringusagedus

Kui ületad API päringusageduse piiri, tagastab API:

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

HTTP-staatus: 429 Too Many Requests Päis: Retry-After: 60

Praegused päringusageduse piirid: 120 päringut minutis API võtme kohta.