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

API дошок, колонок, міток і функцій

Отримуйте дошки проєктів, налаштовуйте канбан-колонки, створюйте мітки, змінюйте функції й керуйте учасниками.

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

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

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

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

Операції дошки використовують company_id і board_id. Колонки мають ID і тип todo, in_progress, done чи custom. Завдання посилаються на column_id, тому отримайте колонки перед створенням чи переміщенням. Тип дошки — kanban, статуси — active, archived, closed.

Мітки є ресурсами дошки з числовими ID та кольорами. Створіть мітку перед призначенням завданню. features — словник із JSON-серіалізованими конфігураціями. Сервер зливає ключі словника. Надісланий ключ замінює повну конфігурацію цієї функції, тому спочатку прочитайте її вкладені налаштування.

Приклад

Отримуйте дошки проєктів, налаштовуйте канбан-колонки, створюйте мітки, змінюйте функції й керуйте учасниками.

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

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

  1. Отримайте дошки простору й виберіть board_id. Прочитайте колонки та конфігурацію.

  2. Створіть етапи й потрібні мітки. Збережіть повернуті ID.

  3. Переміщуйте завдання PATCH-запитами в наявну колонку. Зміни учасників і конфігурації виконують уповноважені керівники.

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

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

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

Навігація endpoint
МетодМаршрутДія
GET/board/list/Список дошок простору
POST/board/list/Створити канбан-дошку
GET/board/Отримати конфігурацію дошки
PATCH/board/Змінити дошку
DELETE/board/Видалити дошку та її роботу
GET/board/columns/Список колонок процесу
POST/board/columns/Створити колонку
PATCH/board/columns/Перейменувати чи впорядкувати колонку
DELETE/board/columns/Видалити колонку
GET/board/tags/Список міток дошки
POST/board/tags/Створити кольорову мітку
PATCH/board/tags/Змінити мітку
DELETE/board/tags/Видалити мітку
PATCH/board/features/Оновити конфігурацію функцій
GET/board/members/Список учасників дошки
POST/board/members/Додати учасника простору до дошки
GET/api/board/list/

Список дошок простору

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

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

{
  "company_id": "demo"
}

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

Приклад cURL

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

Створити канбан-дошку

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

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

{
  "company_id": "demo",
  "title": "Release",
  "type": "kanban",
  "color": "#FF665A"
}

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

Приклад cURL

curl --request POST 'https://tasker.fit/api/board/list/' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "company_id": "demo",
  "title": "Release",
  "type": "kanban",
  "color": "#FF665A"
}'
GET/api/board/

Отримати конфігурацію дошки

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

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

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

Приклад cURL

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

Змінити дошку

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

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

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

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

{
  "status": "archived"
}

Додаткові поля: board_id, title, description, color, type, position, max_assignee_count

Приклад cURL

curl --request PATCH 'https://tasker.fit/api/board/?company_id=demo&board_id=RELEASE' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "status": "archived"
}'
DELETE/api/board/

Видалити дошку та її роботу

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

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

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

Приклад cURL

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

Список колонок процесу

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

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

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

Приклад cURL

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

Створити колонку

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

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

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "title": "To do",
  "kind": "todo"
}

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

Приклад cURL

curl --request POST 'https://tasker.fit/api/board/columns/' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "company_id": "demo",
  "board_id": "RELEASE",
  "title": "To do",
  "kind": "todo"
}'
PATCH/api/board/columns/

Перейменувати чи впорядкувати колонку

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

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

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

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

{
  "title": "Planned",
  "position": 0
}

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

Приклад cURL

curl --request PATCH 'https://tasker.fit/api/board/columns/?company_id=demo&board_id=RELEASE&column_id=todo' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "Planned",
  "position": 0
}'
DELETE/api/board/columns/

Видалити колонку

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

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

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "column_id": "<column-id>"
}

Приклад cURL

curl --request DELETE 'https://tasker.fit/api/board/columns/?company_id=demo&board_id=RELEASE&column_id=%3Ccolumn-id%3E' \
  --header 'Authorization: Bearer <your-api-token>'
GET/api/board/tags/

Список міток дошки

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

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

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

Приклад cURL

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

Створити кольорову мітку

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

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

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "title": "Checkout",
  "color": "#3B82F6"
}

Приклад cURL

curl --request POST 'https://tasker.fit/api/board/tags/' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "company_id": "demo",
  "board_id": "RELEASE",
  "title": "Checkout",
  "color": "#3B82F6"
}'
PATCH/api/board/tags/

Змінити мітку

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

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

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

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

{
  "title": "Payments"
}

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

Приклад cURL

curl --request PATCH 'https://tasker.fit/api/board/tags/?company_id=demo&board_id=RELEASE&tag_id=7' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "Payments"
}'
DELETE/api/board/tags/

Видалити мітку

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

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

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

Приклад cURL

curl --request DELETE 'https://tasker.fit/api/board/tags/?company_id=demo&board_id=RELEASE&tag_id=7' \
  --header 'Authorization: Bearer <your-api-token>'
PATCH/api/board/features/

Оновити конфігурацію функцій

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

Приклад показує одне значення. Сервер об’єднує надіслані ключі з наявним словником; перед зміною вкладених налаштувань прочитайте поточне значення.

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

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

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

{
  "features": {
    "qa": "{\"enabled\":true,\"settings\":{}}"
  }
}

Приклад cURL

curl --request PATCH 'https://tasker.fit/api/board/features/?company_id=demo&board_id=RELEASE' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "features": {
    "qa": "{\"enabled\":true,\"settings\":{}}"
  }
}'
GET/api/board/members/

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

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

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

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

Приклад cURL

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

Додати учасника простору до дошки

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

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

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "member_id": 12,
  "role": "member"
}

Приклад cURL

curl --request POST 'https://tasker.fit/api/board/members/' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "company_id": "demo",
  "board_id": "RELEASE",
  "member_id": 12,
  "role": "member"
}'

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

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

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

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

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

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

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

Читайте далі