Документація
Теми

API коментарів, реакцій, чеклістів та історії

Створюйте обговорення, додавайте матеріали, керуйте пунктами чеклістів і читайте історію завдань чи дошки через REST.

Оновлено 3 жовтня 2026 року3 хв читання

Перед початком

Базова адреса REST — https://tasker.fit/api. Створіть активний токен у профілі та передавайте Authorization: Bearer <your-api-token>. Замініть ID прикладів значеннями, отриманими для свого облікового запису.

Планування робочого процесу

Текст коментаря передається в comment. Коментар належить завданню й може мати attachment_ids. Редагування використовує comment_id у query та зміни в JSON. Реакції є винятком: і додавання, і видалення передають область завдання, comment_id та reaction у JSON, навіть для DELETE.

Завдання містить іменовані чеклісти та пункти. Спочатку створіть чекліст і збережіть його числовий checklist_id для пунктів. Виконання пункту використовує is_selected, а не is_ready. Історія завдання й дошки доступна для читання, але не є загальним експортом чи завантаженням аудиту.

Приклад

Створюйте обговорення, додавайте матеріали, керуйте пунктами чеклістів і читайте історію завдань чи дошки через REST.

Покрокові інструкції / 1

Процес інтеграції

  1. Прочитайте завдання й створіть чекліст із відповідною назвою.

  2. Створіть пункти, збережіть ID та змінюйте is_selected після перевірки.

  3. Додайте коментар прогресу й отримайте ID перед реакцією чи редагуванням. Перевірте записані зміни в історії.

Очікуваний результат: Прочитайте об’єкт data та збережіть ідентифікатори для наступних запитів. Перевіряйте HTTP-статус перед підтвердженням успіху запису.

Endpoint та приклади запитів

ID, токени й дати в прикладах замініть власними значеннями. Кожен приклад показує поля для конкретної дії, а не повну схему відповіді.

Навігація endpoint
МетодМаршрутДія
GET/task/comments/Список коментарів
POST/task/comments/Створити коментар
PATCH/task/comments/Змінити коментар
DELETE/task/comments/Видалити коментар
POST/task/comments/reactions/Додати реакцію
DELETE/task/comments/reactions/Прибрати власну реакцію
POST/task/checklist/Створити чекліст
PATCH/task/checklist/Перейменувати чекліст
DELETE/task/checklist/Видалити чекліст
POST/task/checklist/item/Додати пункт чекліста
PATCH/task/checklist/item/Виконати пункт чекліста
DELETE/task/checklist/item/Видалити пункт чекліста
GET/task/activity/Отримати історію завдання
GET/board/activity/Отримати історію дошки
GET/api/task/comments/

Список коментарів

Потрібна автентифікація та права на операцію.

Параметри URL (приклад)

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>"
}

Додаткові поля: page, limit, q

Приклад cURL

curl --request GET 'https://tasker.fit/api/task/comments/?company_id=demo&board_id=RELEASE&task_id=%3Ctask-id%3E' \
  --header 'Authorization: Bearer <your-api-token>'
POST/api/task/comments/

Створити коментар

Потрібна автентифікація та права на операцію.

Тіло JSON (приклад)

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>",
  "comment": "Checkout verification is ready for review."
}

Додаткові поля: attachment_ids

Приклад cURL

curl --request POST 'https://tasker.fit/api/task/comments/' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>",
  "comment": "Checkout verification is ready for review."
}'
PATCH/api/task/comments/

Змінити коментар

Потрібна автентифікація та права на операцію.

Параметри URL (приклад)

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>",
  "comment_id": 4
}

Тіло JSON (приклад)

{
  "comment": "Verification complete."
}

Додаткові поля: attachment_ids

Приклад cURL

curl --request PATCH 'https://tasker.fit/api/task/comments/?company_id=demo&board_id=RELEASE&task_id=%3Ctask-id%3E&comment_id=4' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "comment": "Verification complete."
}'
DELETE/api/task/comments/

Видалити коментар

Потрібна автентифікація та права на операцію.

Параметри URL (приклад)

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>",
  "comment_id": 4
}

Приклад cURL

curl --request DELETE 'https://tasker.fit/api/task/comments/?company_id=demo&board_id=RELEASE&task_id=%3Ctask-id%3E&comment_id=4' \
  --header 'Authorization: Bearer <your-api-token>'
POST/api/task/comments/reactions/

Додати реакцію

Потрібна автентифікація та права на операцію.

Тіло JSON (приклад)

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>",
  "comment_id": 4,
  "reaction": "👍"
}

Приклад cURL

curl --request POST 'https://tasker.fit/api/task/comments/reactions/' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>",
  "comment_id": 4,
  "reaction": "👍"
}'
DELETE/api/task/comments/reactions/

Прибрати власну реакцію

Потрібна автентифікація та права на операцію.

Тіло JSON (приклад)

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>",
  "comment_id": 4,
  "reaction": "👍"
}

Приклад cURL

curl --request DELETE 'https://tasker.fit/api/task/comments/reactions/' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>",
  "comment_id": 4,
  "reaction": "👍"
}'
POST/api/task/checklist/

Створити чекліст

Потрібна автентифікація та права на операцію.

Тіло JSON (приклад)

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>",
  "title": "Release checks"
}

Додаткові поля: position, items

Приклад cURL

curl --request POST 'https://tasker.fit/api/task/checklist/' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>",
  "title": "Release checks"
}'
PATCH/api/task/checklist/

Перейменувати чекліст

Потрібна автентифікація та права на операцію.

Параметри URL (приклад)

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>",
  "checklist_id": 5
}

Тіло JSON (приклад)

{
  "title": "Payment checks"
}

Додаткові поля: position

Приклад cURL

curl --request PATCH 'https://tasker.fit/api/task/checklist/?company_id=demo&board_id=RELEASE&task_id=%3Ctask-id%3E&checklist_id=5' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "Payment checks"
}'
DELETE/api/task/checklist/

Видалити чекліст

Потрібна автентифікація та права на операцію.

Параметри URL (приклад)

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>",
  "checklist_id": 5
}

Приклад cURL

curl --request DELETE 'https://tasker.fit/api/task/checklist/?company_id=demo&board_id=RELEASE&task_id=%3Ctask-id%3E&checklist_id=5' \
  --header 'Authorization: Bearer <your-api-token>'
POST/api/task/checklist/item/

Додати пункт чекліста

Потрібна автентифікація та права на операцію.

Тіло JSON (приклад)

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>",
  "checklist_id": 5,
  "title": "Verify the confirmation",
  "is_selected": false
}

Додаткові поля: position

Приклад cURL

curl --request POST 'https://tasker.fit/api/task/checklist/item/' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>",
  "checklist_id": 5,
  "title": "Verify the confirmation",
  "is_selected": false
}'
PATCH/api/task/checklist/item/

Виконати пункт чекліста

Потрібна автентифікація та права на операцію.

Параметри URL (приклад)

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>",
  "item_id": 6
}

Тіло JSON (приклад)

{
  "is_selected": true
}

Додаткові поля: title, position

Приклад cURL

curl --request PATCH 'https://tasker.fit/api/task/checklist/item/?company_id=demo&board_id=RELEASE&task_id=%3Ctask-id%3E&item_id=6' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "is_selected": true
}'
DELETE/api/task/checklist/item/

Видалити пункт чекліста

Потрібна автентифікація та права на операцію.

Параметри URL (приклад)

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>",
  "item_id": 6
}

Приклад cURL

curl --request DELETE 'https://tasker.fit/api/task/checklist/item/?company_id=demo&board_id=RELEASE&task_id=%3Ctask-id%3E&item_id=6' \
  --header 'Authorization: Bearer <your-api-token>'
GET/api/task/activity/

Отримати історію завдання

Потрібна автентифікація та права на операцію.

Параметри URL (приклад)

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>"
}

Додаткові поля: actor_ids, action, page, limit, q

Приклад cURL

curl --request GET 'https://tasker.fit/api/task/activity/?company_id=demo&board_id=RELEASE&task_id=%3Ctask-id%3E' \
  --header 'Authorization: Bearer <your-api-token>'
GET/api/board/activity/

Отримати історію дошки

Потрібна автентифікація та права на операцію.

Параметри URL (приклад)

{
  "company_id": "demo",
  "board_id": "RELEASE"
}

Додаткові поля: actor_ids, action, page, limit, q

Приклад cURL

curl --request GET 'https://tasker.fit/api/board/activity/?company_id=demo&board_id=RELEASE' \
  --header 'Authorization: Bearer <your-api-token>'

Поради й вирішення проблем

  • Приклади показують основні поля запиту, а не всі додаткові поля чи повну схему відповіді. Query-поля передавайте в URL, JSON-поля — у тілі. Зберігайте кінцеві слеші адрес.

Поширені запитання

Чи можна використовувати приклади з будь-яким обліковим записом?

Читати й змінювати можна лише доступні токену ресурси. Використовуйте отримані ID просторів, дошок, завдань і числових ресурсів; демонстраційні значення є заповнювачами.

Що робити інтеграції при помилці запиту?

Перевірте HTTP-статус і відповідь помилки. Перевірте ID, обов’язкові поля, активність, строк токена та права. Не повторюйте POST наосліп: попередня спроба могла вже створити ресурс.

Читайте далі