Комментарии

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

PUT https://api.lotinfo.ru/v1/CLIENTS/{id}/COMMENTS

Эта конечная точка позволяет добавлять новые комментарии к клиентам.

Path Parameters

Name	Type	Description
id*	integer	ID клиента, к которому нужно добавить комментарий. Примечание: клиент должен принадлежать пользователю.

Query Parameters

Name	Type	Description
token*	string	Ваш токен.

Request Body

Name	Type	Description
encoding	integer	Кодировка. Значения: 0 - не кодировать, 1 - кодировать. По умолчанию: 0. Пример закодированных символов: "\u0423\u043a\u0430\u0436".
userId	string	ID пользователя.
data*	array	Массив с данными комментариев, которые нужно добавить. Параметры данных: - value (string, required) - Текст комментария.

200 Пример ответа

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 минут после его создания.

Path Parameters

Name	Type	Description
id*	integer	ID клиента, комментарии которого нужно изменить. Примечание: клиент должен принадлежать пользователю.

Query Parameters

Name	Type	Description
token*	string	Ваш токен.

Request Body

Name	Type	Description
encoding	integer	Кодировка. Значения: 0 - не кодировать, 1 - кодировать. По умолчанию: 0. Пример закодированных символов: "\u0423\u043a\u0430\u0436".
userId	integer	ID пользователя.
data*	array	Массив с данными комментариев, которые нужно изменить. Параметры данных: - commentId (integer, required) - ID комментария, данные которого нужно изменить. Примечание: ID комментариев можно узнать при получении данных о клиентах в разделе комментариев. - value (string, required) - Текст комментария.

200 Пример ответа.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "result": [
    {
      "id": 101,
      "update": "ok"
    }
  ]
}

404 Пример ответа на запрос с ошибкой. (Код сервера будет с кодом 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"
    }
  ]
}

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