Перейти в режим автора

Получение сообщений

URL

POST https://w3s.webmoney.com/json/V1/GetMessages.ashx

Заголовки

Тело запроса (JSON)

{
  "reqn": 123456,
  "msgid": 0,
  "maxid": 0,
  "datestart": "2025-09-01T00:00:00",
  "datefinish": "2025-10-02T23:59:59" 
}
Поле Тип Описание
reqn long Номер запроса (идемпотентность/трейсинг), не обязательный.
msgid long id сообщения (0 — не учитывать).
maxid long Верхняя граница id сообщений (0 — не учитывать).
datestart DateTime Начало периода (ISO 8601: YYYY-MM-DDThh:mm:ss).
datefinish DateTime Конец периода (ISO 8601: YYYY-MM-DDThh:mm:ss).

Пример успешного ответа

Ответ формируется потоково: сначала мета и массив messages, затем финальные поля retval/retdesc.

{
  "reqn": 123456,
  "messages": [
    {
      "id": 1010246826,
      "corrwmid": "111122223333",
      "subj": "wmk:link-button=Подробнее",
      "msg": "Предлагаю выполнить задачу ...",
      "dir": 2,
      "sentdate": "2025-09-02T12:00:43" 
    }
  ],
  "retval": 0,
  "retdesc": "OK" 
}

Пример ошибки (частичные данные уже отданы)

Если ошибка произошла после начала выдачи массива messages, ответ завершается флагом ошибки.

{
  "reqn": 123456,
  "messages": [
    { "id": 1, "corrwmid": "123", "subj": null, "msg": "..." }
  ],
  "retval": -2,
  "retdesc": "Partial data followed by error: <описание>" 
}

Пример ошибки (до начала вывода, HTTP 400)

{
  "reqn": 123456,
  "retval": -3,
  "retdesc": "Request processing error: <описание>" 
}

Пример ошибки авторизации (HTTP 401)

{
  "retval": 401,
  "retdesc": "Authorization error: <описание>" 
}

Возможные коды возврата

Код Описание
0 OK
401 Ошибка авторизации (невалидный/отсутствующий JWT)
405 Метод не разрешён (поддерживается только POST)
-2 Данные отданы частично, затем произошла ошибка
-3 Ошибка обработки запроса до начала выдачи данных

Примечания

  • Клиентам необходимо полагаться на retval/retdesc для определения успешности операции,
    даже если HTTP-статус — 200.