Справочник API

taskITnow предоставляет публичное API для интеграции внешних систем с вашим рабочим пространством. С помощью API вы можете программно управлять пространствами, проектами, задачами, полями, участниками, комментариями и файлами.

Авторизация

API использует протокол OAuth 2.0 с типом авторизации Client Credentials.

Получение токена

Для авторизации используйте Client ID и Client Secret, полученные при создании сервисного аккаунта.

Отправьте запрос на получение токена:

POST /oauth/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&client_id=ваш_client_id
&client_secret=ваш_client_secret

В ответ вы получите токен доступа:

{
  "access_token": "eyJhbGciOiJSUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Использование токена

Добавляйте токен в заголовок каждого запроса:

Authorization: Bearer ваш_access_token

Когда срок действия токена истечёт, запросите новый.

Базовый URL

https://api.taskitnow.ru

API разделено на несколько сервисов, каждый из которых отвечает за свою область:

Сервис	Префикс	Описание
Авторизация	`/api/v1/auth`	Токены, сервисные аккаунты
Проекты	`/tt-project`	Проекты и их настройки
Задачи	`/tt-task`	Задачи, колонки, спринты
Роли	`/tt-roles`	Роли, права, участники
Поля	`/tt-field`	Пользовательские и системные поля
Комментарии	`/tt-comment`	Комментарии к задачам
Файлы	`/tt-files`	Загрузка и хранение файлов

Эндпоинты

Рабочие пространства

Метод	Путь	Описание
GET	`/tt-project/workspace/{id}`	Получить пространство
GET	`/tt-project/workspaces`	Список пространств

Проекты

Метод	Путь	Описание
GET	`/tt-project/projects?workspaceId={id}`	Список проектов пространства
GET	`/tt-project/project/{id}`	Получить проект
POST	`/tt-project/project`	Создать проект
PATCH	`/tt-project/project/{id}`	Обновить проект
DELETE	`/tt-project/project/{id}`	Удалить проект

Задачи

Метод	Путь	Описание
GET	`/tt-task/tasks?projectId={id}`	Список задач проекта
GET	`/tt-task/task/{id}`	Получить задачу
POST	`/tt-task/task`	Создать задачу
PATCH	`/tt-task/task/{id}`	Обновить задачу
DELETE	`/tt-task/task/{id}`	Удалить задачу
PATCH	`/tt-task/task/{id}/column`	Переместить задачу в колонку
POST	`/tt-task/task/{id}/archive`	Архивировать задачу

Колонки

Метод	Путь	Описание
GET	`/tt-task/columns?projectId={id}`	Список колонок проекта
POST	`/tt-task/column`	Создать колонку
PATCH	`/tt-task/column/{id}`	Обновить колонку
DELETE	`/tt-task/column/{id}`	Удалить колонку

Поля

Метод	Путь	Описание
GET	`/tt-field/fields?projectId={id}`	Список полей проекта
POST	`/tt-field/field`	Создать поле
PATCH	`/tt-field/field/{id}`	Обновить поле
DELETE	`/tt-field/field/{id}`	Удалить поле
PATCH	`/tt-field/field-value`	Установить значение поля задачи

Участники

Метод	Путь	Описание
GET	`/tt-roles/members?workspaceId={id}`	Список участников пространства
GET	`/tt-roles/members?projectId={id}`	Список участников проекта
POST	`/tt-roles/invitation`	Отправить приглашение

Метод	Путь	Описание
GET	`/tt-comment/comments?taskId={id}`	Список комментариев задачи
POST	`/tt-comment/comment`	Создать комментарий
PATCH	`/tt-comment/comment/{id}`	Обновить комментарий
DELETE	`/tt-comment/comment/{id}`	Удалить комментарий

Файлы

Метод	Путь	Описание
POST	`/tt-files/file`	Загрузить файл
GET	`/tt-files/file/{id}`	Скачать файл
DELETE	`/tt-files/file/{id}`	Удалить файл

Примеры запросов

Получение списка проектов

curl -X GET "https://api.taskitnow.ru/tt-project/projects?workspaceId=ваш_workspace_id" \
  -H "Authorization: Bearer ваш_access_token"

Создание задачи

curl -X POST "https://api.taskitnow.ru/tt-task/task" \
  -H "Authorization: Bearer ваш_access_token" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "id_проекта",
    "columnId": "id_колонки",
    "title": "Новая задача"
  }'

Перемещение задачи в колонку

curl -X PATCH "https://api.taskitnow.ru/tt-task/task/id_задачи/column" \
  -H "Authorization: Bearer ваш_access_token" \
  -H "Content-Type: application/json" \
  -d '{
    "columnId": "id_целевой_колонки"
  }'

Добавление комментария

curl -X POST "https://api.taskitnow.ru/tt-comment/comment" \
  -H "Authorization: Bearer ваш_access_token" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "id_задачи",
    "text": "Текст комментария"
  }'

Коды ошибок

Код	Описание
400	Некорректный запрос — проверьте формат данных
401	Не авторизован — токен отсутствует или истёк
403	Доступ запрещён — недостаточно прав
404	Не найдено — ресурс не существует
409	Конфликт — ресурс уже существует или состояние не позволяет выполнить операцию
422	Ошибка валидации — данные не прошли проверку
429	Слишком много запросов — превышен лимит
500	Внутренняя ошибка сервера

Пример сценария интеграции

Полный цикл создания задачи через API:

Получите токен — отправьте запрос с client_id и client_secret
Получите список проектов — определите, в какой проект добавить задачу
Получите колонки проекта — выберите колонку для новой задачи
Создайте задачу — укажите проект, колонку и название
Установите значения полей — задайте приоритет, исполнителя и другие параметры
Добавьте комментарий — при необходимости оставьте описание или инструкцию

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

Полная техническая документация API с описанием всех параметров запросов и ответов доступна в формате Swagger (OpenAPI). Обратитесь в службу поддержки для получения актуальной ссылки на документацию.

← Сервисные аккаунты