WORKSECTION

Комментарии

Получение комментариев задания через API: get_comments

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

?action=get_comments&id_task=TASK_ID
Возвращает комментарии выбранного задания

Обязательные параметры:
  • id_task — ID задания
Необязательные параметры:
  • extra=files — информация о прикрепленных файлах
Возвращаемые данные:
  • text — текст комментария
  • date_added — дата и время отправки
  • email — email автора комментария
  • name — имя и фамилия автора комментария
  • files — информация о прикрепленных файлах (если в запросе указан параметр extra=files):
    • id — ID файла (можно использовать в методе download для скачивания по API)
    size — размер файла (в байтах)
    name — название файла с расширением
    page — часть ссылки для скачивания напрямую (для полного пути перед полученным значением укажите адрес вашего аккаунта, например https://youraccount.worksection.com/download/123456)

Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:

{
    "status": "ok",
    "data": [
        {
            "id": "COMMENT_ID",
            "page": "/project/PROJECT_ID/TASK_ID/SUBTASK_ID/#comCOMMENT_ID",
            "text": "COMMENT_TEXT",
            "date_added": "YYYY—MM—DD HH:II",
            "user_from": {
                "id": "USER_ID",
                "email": "USER_EMAIL",
                "name": "USER_NAME"
            },
            "files": [
                {
                    "id": "FILE_ID",
                    "size": "FILE_SIZE",
                    "name": "Example.docx",
                    "page": "/download/FILE_ID"
                }
            ],
        }
    ]
}
Эта статья была вам полезна? Да, спасибо! Нет

Создание комментария в задании через API: post_comment

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

?action=post_comment&id_task=TASK_ID&email_user_from=USER_EMAIL&text=TEXT
Создает комментарий в указанном задании
*позволяет прикреплять файлы (см. детальнее)

Обязательные параметры:
  • id_task — ID задания
Условные параметры:
*обязателен минимум один: text или todo
  • text — текст комментария
  • todo⦋⦌ — чекбокс (для получения чеклиста используйте следующую логику: todo⦋⦌=текст1&todo⦋⦌=текст2) 
Необязательные параметры:
  • email_user_from — email автора комментария (автоматически указывается при использовании токена доступа)
  • hidden — список email сотрудников (через запятую), которые будут входить в круг видимости комментария. Для других сотрудников комментарий будет скрыт.
  • mention — список email сотрудников (через запятую), которые будут упомянуты в конце комментария
Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:

{
    "status": "ok",
    "data": {
        "id": "COMMENT_ID",
        "page": "/project/PROJECT_ID/TASK_ID/SUBTASK_ID/#comCOMMENT_ID",
        "text": "COMMENT_TEXT",
        "date_added": "YYYY—MM—DD HH:II",
        "user_from": {
            "id": "USER_ID",
            "email": "USER_EMAIL",
            "name": "USER_NAME"
        }
    }
}
Эта статья была вам полезна? Да, спасибо! Нет
Не работаем с московией. Слава Украине!
esc
или
Распечатать