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

API вкладень і записів часу завдань

Завантажуйте файли multipart, пов’язуйте вкладення із завданнями чи коментарями, отримуйте захищені файли й керуйте часом.

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

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

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

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

Завантажуйте файл на дошку як multipart/form-data. Повернутий ID використовуйте в attachment_ids завдання чи коментаря. Метадані мають JSON, а endpoint файла перенаправляє до сховища. Клієнт має йти за перенаправленням без передавання токена Tasker сторонньому хосту.

Час записується для завершеної роботи через started_at і duration_seconds. Тривалість має бути додатною, а інтервал не може закінчуватися в майбутньому. ID записів — числа, завдань — рядки в області дошки. Підсумок повертає spent_seconds. API доступний для інтеграцій, хоча вебфункцію обліку часу вимкнено.

Приклад

Завантажуйте файли multipart, пов’язуйте вкладення із завданнями чи коментарями, отримуйте захищені файли й керуйте часом.

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

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

  1. Завантажте файл із company_id, board_id та file, збережіть ID вкладення.

  2. Додайте ID до завдання чи коментаря. Для отримання файла використовуйте захищений endpoint і перенаправлення.

  3. Запишіть завершену роботу з початком ISO 8601 і тривалістю в секундах. Перевірте підсумок після збереження.

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

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

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

Навігація endpoint
МетодМаршрутДія
POST/attachment/Завантажити файл дошки
GET/attachment/Отримати метадані вкладення
GET/attachment/file/Отримати перенаправлення завантаження
GET/task/time-logs/Список записів часу
POST/task/time-logs/Записати час завершеної роботи
PATCH/task/time-logs/detail/Змінити запис часу
DELETE/task/time-logs/detail/Видалити запис часу
GET/task/time-logs/summary/Отримати загальний час у секундах
POST/api/attachment/

Завантажити файл дошки

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

multipart/form-data

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "file": "@/path/to/screenshot.png"
}

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

Приклад cURL

curl --request POST 'https://tasker.fit/api/attachment/' \
  --header 'Authorization: Bearer <your-api-token>' \
  --form 'company_id=demo' \
  --form 'board_id=RELEASE' \
  --form 'file=@/path/to/screenshot.png'
GET/api/attachment/

Отримати метадані вкладення

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

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

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

Приклад cURL

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

Отримати перенаправлення завантаження

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

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

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

Приклад cURL

curl --request GET 'https://tasker.fit/api/attachment/file/?company_id=demo&board_id=RELEASE&attachment_id=8' \
  --header 'Authorization: Bearer <your-api-token>'
GET/api/task/time-logs/

Список записів часу

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

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

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

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

Приклад cURL

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

Записати час завершеної роботи

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

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

{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>",
  "started_at": "2026-10-01T09:00:00Z",
  "duration_seconds": 1800,
  "description": "Checkout verification"
}

Приклад cURL

curl --request POST 'https://tasker.fit/api/task/time-logs/' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "company_id": "demo",
  "board_id": "RELEASE",
  "task_id": "<task-id>",
  "started_at": "2026-10-01T09:00:00Z",
  "duration_seconds": 1800,
  "description": "Checkout verification"
}'
PATCH/api/task/time-logs/detail/

Змінити запис часу

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

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

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

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

{
  "duration_seconds": 2400
}

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

Приклад cURL

curl --request PATCH 'https://tasker.fit/api/task/time-logs/detail/?company_id=demo&board_id=RELEASE&task_id=%3Ctask-id%3E&time_log_id=9' \
  --header 'Authorization: Bearer <your-api-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "duration_seconds": 2400
}'
DELETE/api/task/time-logs/detail/

Видалити запис часу

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

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

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

Приклад cURL

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

Отримати загальний час у секундах

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

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

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

Приклад cURL

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

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

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

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

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

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

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

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

Читайте далі