Skip to content
API дар марҳилаи beta аст ва бидуни огоҳии пешакӣ тағйир ёфта метавонад.

Рамзҳои хато

HitKey ҷавобҳои хатои сохторманд бармегардонад. Ин саҳифа ҳамаи рамзҳои хаторо аз рӯи категория номбар мекунад.

Формати ҷавоб

Аксари ҷавобҳои хато аз ин сохтор пайравӣ мекунанд:

json
{
  "error": "Human-readable description",
  "code": "ERROR_CODE"
}

Хатоҳои тасдиқи AdonisJS (HTTP 422) формати массив истифода мебаранд:

json
{
  "errors": [
    {
      "message": "Validation failed",
      "rule": "required",
      "field": "email"
    }
  ]
}

Хатоҳои тасдиқи ҳувият

РамзHTTPТавсиф
INVALID_CREDENTIALS401Email ё парол нодуруст аст
EMAIL_NOT_VERIFIED401Email ҳанӯз тасдиқ нашудааст

Хатоҳои 2FA

РамзHTTPТавсиф
INVALID_CODE400Рамзи TOTP нодуруст аст
SETUP_NOT_INITIATED4002FA барои ин корбар танзим нашудааст
NOT_ENABLED4002FA фаъол нест (ғайрифаъол кардан мумкин нест)
INVALID_TOKEN400Challenge token беэътибор ё мӯҳлаташ гузашта

Хатоҳои идоракунии Email

РамзHTTPТавсиф
EMAIL_ALREADY_IN_USE400Email ба ҳисоби дигар бақайд шудааст
INVALID_CODE400Рамзи тасдиқ нодуруст аст
CODE_EXPIRED400Мӯҳлати рамзи тасдиқ гузаштааст
TOO_MANY_ATTEMPTS400Аз ҳадди аксари кӯшишҳои тасдиқ гузашт
EMAIL_NOT_FOUND404Email ба ин ҳисоб вобаста нест
EMAIL_NOT_VERIFIED400Email ҳанӯз тасдиқ нашудааст
ONLY_VERIFIED_EMAIL400Нест кардани ягона email-и тасдиқшуда мумкин нест

Хатоҳои профил

РамзHTTPТавсиф
USERNAME_INVALID400Формати номи корбарӣ нодуруст аст
USERNAME_RESERVED400Номи корбарӣ аз ҷониби система захира шудааст
USERNAME_TAKEN409Номи корбарӣ аллакай истифода мешавад

Хатоҳои бақайдгирӣ

РамзHTTPТавсиф
EMAIL_ALREADY_VERIFIED400Ин email аллакай тасдиқ шудааст
INVALID_CODE400Рамзи тасдиқ нодуруст аст
TOO_MANY_ATTEMPTS400Аз ҳадди аксари кӯшишҳо гузашт (рамзи нав дархост кунед)
CODE_EXPIRED400Мӯҳлати рамзи тасдиқ гузаштааст
NO_CODE400Тасдиқи интизорӣ барои ин email нест

Хатоҳои барқарорсозии парол

РамзHTTPТавсиф
INVALID_TOKEN400Token-и барқарорсозӣ беэътибор аст
TOKEN_EXPIRED400Мӯҳлати token-и барқарорсозӣ гузаштааст

Хатоҳои OAuth

Нуқтаҳои ниҳоии OAuth паёмҳои хатои хоношавандаро бармегардонанд, на рамзҳои хатои сохторманд:

json
{
  "error": "Invalid client_id"
}

Паёмҳои маъмулии хато:

ПаёмHTTPТавсиф
"Invalid client_id"400client_id номаълум
"redirect_uri doesn't match"400redirect_uri бо URI-и бақайдшуда мувофиқ нест
"Invalid or expired authorization code"400Code аллакай истифода шуда ё мӯҳлаташ гузашта

Хатоҳои лоиҳа

РамзHTTPТавсиф
NOT_PROJECT_MEMBER403Корбар аъзои лоиҳа нест
ALREADY_MEMBER400Корбар аллакай аъзои лоиҳа аст
CANNOT_TRANSFER_TO_SELF400Интиқоли моликият ба худ мумкин нест
INVITE_ALREADY_EXISTS400Даъватнома барои ин email аллакай вуҷуд дорад
INVITE_NOT_FOUND404Даъватнома ёфт нашуд
INVITE_EXPIRED400Мӯҳлати даъватнома гузаштааст
EMAIL_MISMATCH400Email-и корбар бо email-и даъватнома мувофиқ нест

Рамзҳои ҳолати HTTP

ҲолатМаъно
200Муваффақият
201Сохта шуд
202Қабул шуд (challenge-и 2FA)
400Дархости нодуруст / хатои тасдиқ
401Тасдиқ нашудааст
403Манъ (иҷозатҳо кофӣ нест)
404Ёфт нашуд
409Зиддият (масалан, номи корбарӣ гирифта шудааст)
422Коркард мумкин нест (тасдиқ)
429Дархостҳо бисёранд
500Хатои дохилии сервер

HitKey Service License.