Комментарии к заданию
Список комментариев к заданию
GET /issues/{id}/comments
Структура запроса:
GET /issues/185/comments?token=puqw129npc074a
id: id задания
token: ключ доступа
Ответ:
Статус: 200 — успешное выполнение
Формат: json
[{
"id": 2615,
"comment": "root-comment",
"date": 1415375223695,
"issueId": 185,
"referenceId": null,
"userInfo": {
"id": 1425,
"name": "Администратор №1",
"photo": {
"id":2,
"name": "photo.png"
}
},
"level": 0,
"files": [{
"id": 5022,
"fileType": {
"id": 1,
"type": "photos"
},
"name": "photo.jpg"
}],
"coordinates": [{
"id": 22,
"geom": {
"type": "Point",
"coordinates": [47.5486, 55.028]
},
"address": "address"
}]
},...]
Добавление комментария
POST /issues/{id}/comments
Структура запроса:
POST /issues/35/comments?token=puqw129npc074a
id: id задания
token: ключ доступа
Пример запроса:
Формат: json
{
"comment": "Следит за ходом выполнения задания",
"issueId": 35,
"referenceId": null,
"files": [{
"uuid": "p19duu3hoe1it5n1v1r878e0iun9.docx",
"name": "file.docx",
"description": "",
"geom": null
}],
"photos": [{
"uuid": "p19duu2s9f1ktr16cp933qam58s5.png",
"name": "photo.png",
"description": "",
"geom": null
}],
"videos": [{
"uuid": "p19duu3hoe1it5n1v1r878e0iun9.flv",
"name": "video.flv",
"description": "",
"geom": null
}],
"sounds": [{
"uuid": "p19duu3hoe1it5n1v1r878e0iun9.mp3",
"name": "audio.mp3",
"description": "",
"geom": null
}],
"coordinates": [{
"address": "Татарстан, Казань, улица Павлюхина, 57",
"geom": {
"type": "Point",
"coordinates": [49.138197898864746,
55.77478084140647]
}
}..]
}
// комментарий, строка
// id задания, целое число
// ответ на комментарий, целое число
// загруженные файлы, прикрепленный к комментарию
// уникальное название файла, строка
// название файла, строка
// описание, строка
// геометрия, geojson
// загруженные фотографии, прикрепленные к комментарию
// уникальное имя фотографии, строка
// название фотографии, строка
// описание, строка
// геометрия, geojson
// загруженные видео, прикрепленный к комментарию
// уникальное название файла, строка
// название файла, строка
// описание, строка
// геометрия, geojson
// загруженные аудио-файлы, прикрепленный к комментарию
// уникальное название файла, строка
// название файла, строка
// описание, строка
// геометрия, geojson
// список координат, прикрепленных к комментарию
// адрес, строка
// информация о точке местоположения
// тип геометрии, строка
// координаты, массив
Ответ:
Статус: 200 — успешное выполнение
Формат: json
{
"id": 1814,
"comment": "Произведена фото фиксация проемов",
"date": 1406299212130,
"issueId": 19468,
"referenceId": null,
"userInfo": {
"id": 1444,
"name": "Сергеев С.В. (замерщик)",
"photo": {
"id":2,
"name": "photo.png"
}
},
"level":0,
"files": [{
"id": 5022,
"fileType": {
"id": 1,
"type": "photos"
},
"name": "photo.jpg"
}],
"coordinates": [{
"id": 22,
"geom": {
"type": "Point",
"coordinates": [47.5486, 55.028]
},
"address": "address"
}]
}
// id комментария, целое число
// комментарий, строка
// дата добавления, timestamp
// id задания, целое число
// null, либо id комментария, ответом на который создан данный, целое число
// данные пользователя, объект
// id пользователя, целое число
// имя пользователя, строка
// информация о фотографии
// id фотографии, целое число
// название фотографии, строка
// уровень вложенности комментария, целое число
// список файлов, прикрепленных к комментарию
// id файла, целое число
// тип файла
// название файла
// список координат, которые прикреплены к задаче
Удаление комментария
DELETE /issues/{id}/comments/{commentId}
Структура запроса:
DELETE /issues/35/comments/24?token=puqw129npc074a
commentId: id комментария
id: id задания
token: ключ доступа
Ответ:
Статус: 200 — успешное выполнение
Формат: json
{
"id": 24
}
Возможные статусы ответов сервера при ошибке:
Статус: 401 — необходима авторизация
Формат: text/plain
Содержит описание ошибки
Содержит описание ошибки
Статус: 403 — доступ запрещен
Формат: text/plain
Содержит описание ошибки
Содержит описание ошибки
Статус: 404 — не найдено
Формат: text/plain
Содержит описание ошибки
Содержит описание ошибки
Статус: 500 — ошибка на сервере
Формат: text/plain
Содержит описание ошибки
Содержит описание ошибки