Перейти к содержимому
Last updated

Общий формат ответа

Все ответы API MoreLogin имеют стандартный формат JSON.


Структура ответа

{
  "code": 0,
  "msg": null,
  "data": {},
  "requestId": "unique-request-id"
}
ПолеТипОписание
codeintegerКод результата. 0 = успех, другие значения указывают на ошибки.
msgстрока | нольСообщение об ошибке. null в случае успеха
dataобъект | массив | нольПолезная нагрузка ответа. Структура зависит от конечной точки
requestIdstringУникальный идентификатор запроса. Укажите это при обращении в службу поддержки.

Успешный ответ

{
  "code": 0,
  "msg": null,
  "data": {
    "id": 1234567890
  },
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Ошибка ответа

{
  "code": 99001,
  "msg": "Invalid parameters",
  "data": null,
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Разбивка на страницы ответов

Конечные точки списка возвращают данные с разбивкой на страницы в следующем формате:

{
  "code": 0,
  "msg": null,
  "data": {
    "total": 100,
    "current": 1,
    "pages": 10,
    "dataList": [
      { ... },
      { ... }
    ]
  },
  "requestId": "..."
}
ПолеОписание
totalОбщее количество записей
currentТекущий номер страницы
pagesОбщее количество страниц
dataListМассив записей для текущей страницы

Коды состояния HTTP

СтатусОписание
200Запрос успешно обработан (проверьте поле code для получения бизнес-результата)
401Неавторизованный — недействительный или просроченный токен доступа.
403Запрещено — недостаточно разрешений
429Слишком много запросов — превышен лимит скорости
500Внутренняя ошибка сервера — обратитесь в службу поддержки.

Совет. Всегда проверяйте поле code в тексте ответа, а не только код статуса HTTP. Статус HTTP 200 с кодом code: 99001 означает, что запрос был получен, но не прошел проверку.