REST API
NUBL предоставляет REST API для интеграции с внешними сервисами и автоматизации рабочих процессов.
Базовый URL
https://nubl.space/api
Аутентификация
Все запросы (кроме регистрации и входа) требуют JWT-токен в заголовке:
Authorization: Bearer <access_token>
Для операций внутри воркспейса дополнительно используется:
WS-Member-Token: <workspace_member_token>
Подробнее в разделе Аутентификация.
Формат ответов
API возвращает данные в формате JSON. Успешные ответы содержат данные напрямую, ошибки возвращаются в формате:
{
"statusCode": 400,
"reason": "validation.error",
"message": "Описание ошибки"
}
Разделы API
| Раздел | Базовый путь | Описание |
|---|---|---|
| Аутентификация | /api/user | Регистрация, вход, управление токенами |
| Воркспейсы | /api/workspace | Управление воркспейсами и участниками |
| Доски | /api/workspace/:id/board | Управление досками, колонками, тегами |
| Задачи | /api/workspace/:id/task | CRUD задач, комментарии, назначения |
| Страницы | /api/workspace/:id/page | Иерархия страниц и контроль доступа |
Коды ответов
| Код | Описание |
|---|---|
200 | Успешный запрос |
201 | Ресурс создан |
400 | Ошибка валидации |
401 | Не авторизован |
403 | Доступ запрещён |
404 | Ресурс не найден |
500 | Внутренняя ошибка сервера |