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

API завдань, пошуку, шаблонів і помилок

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

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

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

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

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

Створення приймає company_id, board_id, column_id і name в JSON. Читання й зміна використовують company_id, board_id і task_id у query. Внутрішній task_id відрізняється від task_number: використовуйте повернутий ID навіть для нумерованої картки. Змінюйте лише потрібні поля.

Список за замовчуванням містить звичайні неархівні завдання. Для шаблонів задавайте is_template=true, для архіву — is_archived=true. Числові assignee_ids передаються повторюваними query-ключами. Пріоритети: low, medium, high, urgent; типи: task, bug, research, improvement, story. Дати використовуйте у форматі ISO 8601 із часовим поясом або null для очищення.

Приклад

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

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

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

  1. Отримайте дошку й ID колонок, потім створіть завдання зі зрозумілою назвою.

  2. Збережіть task_id із відповіді. Через PATCH призначайте учасників, строки чи нову колонку.

  3. Шукайте роботу GET-списками з фільтрами. Для архівування задавайте час, а DELETE використовуйте для остаточного вилучення.

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

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

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

Навігація endpoint
МетодМаршрутДія
GET/task/list/Список і пошук завдань дошки
POST/task/list/Створити завдання
GET/task/Отримати завдання за внутрішнім ID
PATCH/task/Змінити поля чи перемістити завдання
PATCH/task/Архівувати завдання
DELETE/task/Назавжди видалити завдання
POST/task/clone/Клонувати завдання
POST/task/create-from-template/Створити із шаблону
POST/task/bug-report/Створити структуровану помилку
GET/company/tasks/list/Пошук завдань у просторі
GET/company/assigned/Список власних завдань
GET/company/inbox/Список спостережуваних завдань і згадок
GET/company/overdue/Список прострочених завдань для керівників
GET/api/task/list/

Список і пошук завдань дошки

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

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

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "page": 1,
  "limit": 20
}

Додаткові поля: q, column_id, assignee_ids, priority, type, parent_task_id, is_archived, is_template, order_by

Приклад cURL

curl --request GET 'https://tasker.fit/api/task/list/?company_id=demo&board_id=RELEASE&page=1&limit=20' \
  --header 'Authorization: Bearer <your-api-token>'
POST/api/task/list/

Створити завдання

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

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

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "column_id": "todo",
  "name": "Verify checkout",
  "priority": "high",
  "assignee_ids": [
    12
  ]
}

Додаткові поля: description, parent_task_id, attachment_ids, tag_ids, type, position, starts_at, due_at, is_ready, is_template, variables

Приклад cURL

curl --request POST 'https://tasker.fit/api/task/list/' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "company_id": "demo",
  "board_id": "RELEASE",
  "column_id": "todo",
  "name": "Verify checkout",
  "priority": "high",
  "assignee_ids": [
    12
  ]
}'
GET/api/task/

Отримати завдання за внутрішнім ID

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

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

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

Приклад cURL

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

Змінити поля чи перемістити завдання

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

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

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

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

{
  "column_id": "progress",
  "priority": "high"
}

Додаткові поля: name, description, assignee_ids, attachment_ids, tag_ids, parent_task_id, starts_at, due_at, completed_at, archived_at, is_ready, is_template, variables, position

Приклад cURL

curl --request PATCH 'https://tasker.fit/api/task/?company_id=demo&board_id=RELEASE&task_id=%3Ctask-id%3E' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "column_id": "progress",
  "priority": "high"
}'
PATCH/api/task/

Архівувати завдання

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

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

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

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

{
  "archived_at": "2026-10-03T09:00:00Z"
}

Приклад cURL

curl --request PATCH 'https://tasker.fit/api/task/?company_id=demo&board_id=RELEASE&task_id=%3Ctask-id%3E' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "archived_at": "2026-10-03T09:00:00Z"
}'
DELETE/api/task/

Назавжди видалити завдання

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

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

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

Приклад cURL

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

Клонувати завдання

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

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

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

Приклад cURL

curl --request POST 'https://tasker.fit/api/task/clone/' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>",
  "column_id": "todo"
}'
POST/api/task/create-from-template/

Створити із шаблону

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

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

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<template-task-id>",
  "column_id": "todo",
  "variables": {
    "version": "1.2",
    "environment": "staging"
  }
}

Приклад cURL

curl --request POST 'https://tasker.fit/api/task/create-from-template/' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<template-task-id>",
  "column_id": "todo",
  "variables": {
    "version": "1.2",
    "environment": "staging"
  }
}'
POST/api/task/bug-report/

Створити структуровану помилку

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

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

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "column_id": "todo",
  "title": "Expired card accepted",
  "steps_to_reproduce": "Submit an expired test card",
  "actual_result": "Payment succeeds",
  "expected_result": "Payment rejected",
  "severity": "major",
  "priority": "high"
}

Додаткові поля: description, assignee_ids, attachment_ids, tag_ids, due_at, bug_type

Приклад cURL

curl --request POST 'https://tasker.fit/api/task/bug-report/' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "company_id": "demo",
  "board_id": "RELEASE",
  "column_id": "todo",
  "title": "Expired card accepted",
  "steps_to_reproduce": "Submit an expired test card",
  "actual_result": "Payment succeeds",
  "expected_result": "Payment rejected",
  "severity": "major",
  "priority": "high"
}'
GET/api/company/tasks/list/

Пошук завдань у просторі

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

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

{
  "company_id": "demo",
  "q": "checkout",
  "page": 1,
  "limit": 20
}

Приклад cURL

curl --request GET 'https://tasker.fit/api/company/tasks/list/?company_id=demo&q=checkout&page=1&limit=20' \
  --header 'Authorization: Bearer <your-api-token>'
GET/api/company/assigned/

Список власних завдань

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

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

{
  "company_id": "demo"
}

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

Приклад cURL

curl --request GET 'https://tasker.fit/api/company/assigned/?company_id=demo' \
  --header 'Authorization: Bearer <your-api-token>'
GET/api/company/inbox/

Список спостережуваних завдань і згадок

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

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

{
  "company_id": "demo"
}

Приклад cURL

curl --request GET 'https://tasker.fit/api/company/inbox/?company_id=demo' \
  --header 'Authorization: Bearer <your-api-token>'
GET/api/company/overdue/

Список прострочених завдань для керівників

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

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

{
  "company_id": "demo"
}

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

Приклад cURL

curl --request GET 'https://tasker.fit/api/company/overdue/?company_id=demo' \
  --header 'Authorization: Bearer <your-api-token>'

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

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

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

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

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

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

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

Читайте далі