Довідник REST API Tasker.fit та посібник інтеграції
Створюйте інтеграції з REST API Tasker.fit: автентифікація, простори, дошки, завдання, співпраця, QA-сесії, файли, облік часу й підписки.
Перед початком
Створіть активний bearer-токен і використовуйте обліковий запис із правами на потрібну операцію. Посібник відокремлює можливості API від вебінтерфейсу.
Планування робочого процесу
Інтеграції варто починати із запиту читання для перевірки автентифікації й області. Отримайте ID простору, потім дошку для даних проєкту. API-клієнти та Python SDK описують операції й поля, але підтримка backend не означає наявності вебекрана. Це важливо для запрошень, часу, батьківських завдань і підписок.
Обробляйте пагінацію, не вважаючи першу відповідь повним списком. Відрізняйте помилки доступу від успішного порожнього результату та враховуйте обгортку відповіді data. Перед записом перевіряйте цільові ID і прийняті поля. Клієнт має повідомляти про відхилення, а не стверджувати, що завдання, доступ чи підписка змінилися.
Приклад
Внутрішній звіт може входити з іменованим токеном, отримувати простори й дошки та читати завдання сторінками. Підсумки часу доступні через API, хоча вікно завдання не має повного модуля обліку часу.
Покрокові інструкції / 1
Виконайте перший авторизований запит
Створіть токен у профілі. Збережіть його в приватних налаштуваннях клієнта та перевірте активність і строк дії.
Надішліть GET до /api/company/list/ із заголовком Authorization: Bearer, як у прикладі нижче.
Прочитайте об’єкт data та виберіть доступний ідентифікатор простору. Використовуйте API-клієнт чи Python SDK для отримання дошок або завдань із пагінацією.
Якщо автентифікація неуспішна, перевірте стан, строк і заголовок токена. Якщо доступ заборонено, перевірте права простору й дошки.
Очікуваний результат: Ви підтвердили автентифікацію токена й можете використовувати підтримувані операції нижче.
Посібники та довідники API
Виберіть область інтеграції. Кожен посібник містить послідовність дій, параметри, JSON і приклади cURL для конкретних операцій.
Автентифікація API, токени й доступ до облікового запису
Автентифікуйте REST-інтеграції токенами bearer, розрізняйте JWT-сесії браузера, керуйте обліковими даними й читайте профіль.
8 прикладів запитів →API просторів, учасників і запрошень
Створюйте й змінюйте простори, переглядайте учасників, надсилайте запрошення та приймайте чи відхиляйте їх через API.
14 прикладів запитів →API дошок, колонок, міток і функцій
Отримуйте дошки проєктів, налаштовуйте канбан-колонки, створюйте мітки, змінюйте функції й керуйте учасниками.
16 прикладів запитів →API завдань, пошуку, шаблонів і помилок
Створюйте, отримуйте, змінюйте, архівуйте, клонуйте й видаляйте завдання, фільтруйте списки та використовуйте шаблони й звіти про помилки.
13 прикладів запитів →API коментарів, реакцій, чеклістів та історії
Створюйте обговорення, додавайте матеріали, керуйте пунктами чеклістів і читайте історію завдань чи дошки через REST.
14 прикладів запитів →API сценаріїв QA, кейсів і тестових сесій
Автоматизуйте підготовку сценаріїв, починайте сесії, записуйте результати кейсів, створюйте пов’язані помилки та завершуйте QA.
15 прикладів запитів →API вкладень і записів часу завдань
Завантажуйте файли multipart, пов’язуйте вкладення із завданнями чи коментарями, отримуйте захищені файли й керуйте часом.
8 прикладів запитів →API підписок, оплати й підтримки
Читайте плани й використання, створюйте оплату, переглядайте транзакції, скасовуйте підписки та надсилайте звернення.
8 прикладів запитів →Адреса API, запити й відповіді
Базова адреса — https://tasker.fit/api. Зберігайте кінцевий слеш маршрутів. Для інтеграцій передавайте Authorization: Bearer зі своїм активним API-токеном. Вебсесії використовують Authorization: JWT з access-токеном; refresh-токен призначений лише для оновлення сесії.
company_id означає робочий простір, board_id — дошку. Отримуйте значення зі списків API: назва й видимий номер завдання не замінюють внутрішні ID. Приклади показують окремо query-параметри й тіло JSON. Надсилайте Content-Type: application/json для JSON; завантаження файлів використовує multipart/form-data.
Списки підтримують page, limit і q там, де це вказано в довіднику. Передавайте масиви фільтрів повторюваними ключами, наприклад assignee_ids=12&assignee_ids=18. Перевіряйте доступні поля кожного endpoint, а не копіюйте фільтри між різними списками.
GET /api/task/list/?company_id=demo&board_id=product&page=1&limit=20&assignee_ids=12&assignee_ids=18Успішна відповідь містить дані в data. Назви колекцій залежать від endpoint, наприклад companies або tasks. Перевіряйте HTTP-статус і вміст відповіді, перш ніж читати data: помилки валідації, доступу та відсутні об’єкти потребують окремої обробки. Деякі операції, зокрема видалення, можуть не повертати об’єкт даних; завантаження файла перенаправляє на сховище.
Для 401 перевірте заголовок, строк і стан токена; для 403 — роль та доступ до простору й дошки. Якщо виникає 404, перевірте ID й контекст. Виправляйте поля за повідомленням валідації. Не повторюйте автоматично створення після невизначеної мережевої помилки: спочатку перевірте, чи об’єкт уже створено.
Приклад
curl --request GET 'https://tasker.fit/api/company/list/' \
--header 'Authorization: Bearer <your-api-token>'
# Successful responses wrap payloads in data:
# { "status": "success", "data": { "companies": [...] } }Довідник функцій
Прийняття запрошень через API
Отримуйте запрошення та приймайте або відхиляйте їх за кодом через API. Екрана цього процесу для одержувача у вебзастосунку поки немає.
Зміна ролі учасника через API
Оновлюйте роль учасника простору через API за відповідних прав. Поточний екран учасників лише показує ролі.
Видалення простору через API
API компанії підтримує видалення простору авторизованим користувачем. Кнопки видалення в поточних налаштуваннях простору немає.
Видалення облікового запису через API
Авторизований endpoint учасника підтримує видалення облікового запису. Поточні екрани профілю не містять цієї дії.
Батьківські й дочірні завдання через API
Створюйте або змінюйте зв’язок завдання з батьківським завданням через API. Повного процесу керування підзавданнями у вебінтерфейсі поки немає.
Записи часу через API
Отримуйте, створюйте, редагуйте й видаляйте записи часу завдання з початком, тривалістю та описом. Функцію обліку часу у вебінтерфейсі поки вимкнено.
Підсумок часу через API
Отримуйте загальний витрачений час завдання через endpoint підсумку. Вікно завдання поки не містить робочого модуля цього огляду.
Історія оплат через API
Переглядайте транзакції підписки через API або SDK. Поточний екран підписок показує плани й використання без історії платежів.
Скасування й вимкнення підписки через API
Backend підтримує операції скасування та вимкнення підписки. Поточний екран підписок не містить відповідних кнопок.
Програмне керування даними
API підтримує операції з просторами, дошками, колонками, мітками, завданнями, коментарями, чеклістами та файлами. Використовуйте доступні фільтри й пагінацію з урахуванням прав облікового запису.
Поради й вирішення проблем
- За потреби передавайте company_id і board_id для запитів дошки. ID, поля й права залежать від endpoint; використовуйте моделі API-клієнта чи SDK для потрібної операції.
- Видалення й зміни підписок через API впливають на реальні дані. Перевіряйте цільовий обліковий запис чи простір і дію перед записом.
Поширені запитання
Чи доступні API-можливості у вебінтерфейсі?
Не обов’язково. Ця сторінка окремо описує підтримку backend і клієнтів без повного процесу у вебінтерфейсі.
Чи замінює Python SDK права токена?
Ні. Запити SDK залишаються авторизованими запитами API з тими самими правами облікового запису й проєкту.