Объедините свои инструменты.
API для проектов, задач и прогресса с проверкой прав доступа.
Аутентификация
Создайте токен чтения или записи в настройках. Передайте Authorization: Bearer YOUR_TOKEN. Токен показывается один раз, хранится в виде хеша, имеет срок действия и может быть отозван. Права команды и проекта действуют для каждого токена. Токен записи не расширяет права наблюдателя.
Браузерные сеансы работают с тем же API, но для любых изменений нужен заголовок X-CSRFToken . Формат ошибок: {"error":{"code":400,"message":"…"}}. Списки возвращают data и pagination. Для постраничного просмотра используются page и per_page (не более 100).
Выполнить запрос чтения
Токен остаётся в памяти этой страницы и отправляется только на этот сервер. В хранилище браузера он не сохраняется.
Your response will appear here.
Ресурсы
| Метод | Путь | Поведение |
|---|---|---|
| GET | /me | Текущий пользователь |
| GET / POST | /projects | Список или создание проектов |
| GET / PATCH / DELETE | /projects/{id} | Просмотр, изменение или удаление доступного проекта |
| GET / POST | /tasks | Список или создание задач |
| GET / PATCH / DELETE | /tasks/{id} | Просмотр, изменение или удаление доступной задачи |
| GET | /analytics/overview | Показатели с фильтрами даты, проекта, команды и статуса |
Создать задачу
POST /api/v1/tasks
Authorization: Bearer YOUR_WRITE_TOKEN
Content-Type: application/json
{"project_id": 1, "title": "Ship something useful", "priority": "high"}Успех: HTTP 201 с оболочкой data. Чтение/изменение: 200. Удаление: 204. Неверные данные/CSRF: 400. Нет авторизации: 401. Только чтение: 403. Ресурс недоступен: 404. Конфликт: 409. Превышение частоты: 429. Передайте version из ответа задачи с PATCH для защиты от устаревших изменений. Передайте 0 для снятия исполнителя. Команду или пространство нельзя изменить после создания проекта.