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.