Комментарии

put
Добавление комментариев

https://api.lotinfo.ru/v1/CLIENTS/{id}/COMMENTS
Эта конечная точка позволяет добавлять новые комментарии к клиентам.
Request
Response
Request
Path Parameters
id
required
integer
ID клиента, к которому нужно добавить комментарий. Примечание: клиент должен принадлежать пользователю.
Query Parameters
token
required
string
Ваш токен.
Form Data Parameters
encoding
optional
integer
Кодировка. Значения: 0 - не кодировать, 1 - кодировать. По умолчанию: 0. Пример закодированных символов: "\u0423\u043a\u0430\u0436".
userId
required
string
ID пользователя.
data
required
array
Массив с данными комментариев, которые нужно добавить. Параметры данных: - value (string, required) - Текст комментария.
Response
200: OK
Пример ответа
HTTP/1.1 200 OK
Content-Type: application/json
{
"result": [
{
"id": 201,
"put": "ok"
},
{
"id": 202,
"put": "ok"
}
]
}

Пример запроса

PUT https://api.lotinfo.ru/v1/CLIENTS/31341050/COMMENTS/?TOKEN={ваш_токен} HTTP/1.1
Content-Type: application/json
{
"userId": 123,
"data": [
{
"value": "Новый комментарий 1"
},
{
"value": "Новый комментарий 2"
}
]
}

post
Изменение комментариев

https://api.lotinfo.ru/v1/CLIENTS/{id}/COMMENTS
Эта конечная точка позволяет изменять данные комментариев. Изменять комментарий можно только в течение 5 минут после его создания.
Request
Response
Request
Path Parameters
id
required
integer
ID клиента, комментарии которого нужно изменить. Примечание: клиент должен принадлежать пользователю.
Query Parameters
token
required
string
Ваш токен.
Form Data Parameters
encoding
optional
integer
Кодировка. Значения: 0 - не кодировать, 1 - кодировать. По умолчанию: 0. Пример закодированных символов: "\u0423\u043a\u0430\u0436".
userId
required
integer
ID пользователя.
data
required
array
Массив с данными комментариев, которые нужно изменить. Параметры данных: - commentId (integer, required) - ID комментария, данные которого нужно изменить. Примечание: ID комментариев можно узнать при получении данных о клиентах в разделе комментариев. - value (string, required) - Текст комментария.
Response
200: OK
Пример ответа.
HTTP/1.1 200 OK
Content-Type: application/json
{
"result": [
{
"id": 101,
"update": "ok"
}
]
}
404: Not Found
Пример ответа на запрос с ошибкой. (Код сервера будет с кодом 200.)
HTTP/1.1 200 OK
Content-Type: application/json
{
"errors": [
{
"error": 21,
"error_text": "У клиента с этим id (305) нет комментария с id 101, созданнового в течении последних 5 минут.",
"error_field": "comments"
}
]
}

Пример запроса

POST https://api.lotinfo.ru/v1/CLIENTS/305/COMMENTS/?TOKEN={ваш_токен} HTTP/1.1
Content-Type: application/json
{
"userId": 123,
"data": [
{
"commentId": 101,
"value": "Изменённый комментарий 1"
}
]
}

Удалять комментарии нельзя.