Aladdin Public API

Задачи (tasks:read)

GET /v1/tasks и GET /v1/tasks/{id} — примеры запросов, 200 и ошибки.

Задачи (tasks:read)

Все методы ниже — только GET. Запись (POST / PATCH / DELETE) в публичном API не поддерживается.

Базовый URL: https://api.aladdinhub.io/v1
Скоуп токена: tasks:read
Заголовок: Authorization: Bearer ald_…

boardId обязателен для GET /tasks. Без доски список не отдаётся (400).

Общие ошибки: Ошибки. Даты: Фильтры по датам.

QueryОбязательныйОписание
boardIdдаUUID доски
columnIdнетТолько задачи из этой колонки (должна быть на boardId)
authorIdнетАвтор
assigneeIdнетИсполнитель
isUrgentнетtrue / false — срочные / обычные
slaStatusнетcompleted | on_time | overdue (по deadlineEnd и isClosed)
searchнетПоиск по тексту
даты / cursor / limitнетсм. пагинацию и даты

slaStatus: completed — закрыта; on_time — открыта и дедлайн не просрочен (или дедлайна нет); overdue — открыта и deadlineEnd < сейчас.

GET /tasks — список (базовый, с доской)

Запрос

GET /v1/tasks?boardId=33333333-3333-4333-8333-333333333333&limit=2 HTTP/1.1
Host: api.aladdinhub.io
Authorization: Bearer ald_demoPrefix_mockSecretExampleOnly
Accept: application/json
curl -sS \
  -H "Authorization: Bearer ald_demoPrefix_mockSecretExampleOnly" \
  -H "Accept: application/json" \
  "https://api.aladdinhub.io/v1/tasks?boardId=33333333-3333-4333-8333-333333333333&limit=2"

Ответ 200

{
  "data": [
    {
      "id": "22222222-2222-4222-8222-222222222222",
      "title": "Example task title",
      "description": "Short mock description",
      "columnId": "44444444-4444-4444-8444-444444444444",
      "boardId": "33333333-3333-4333-8333-333333333333",
      "boardName": "Example board",
      "columnName": "In progress",
      "author": {
        "id": "11111111-1111-4111-8111-111111111111",
        "name": "Example Author",
        "role": "manager",
        "department": "tech",
        "team": "platform",
        "isActive": true
      },
      "assignee": {
        "id": "11111111-1111-4111-8111-111111111112",
        "name": "Example Assignee",
        "role": "developer",
        "department": "tech",
        "team": "platform",
        "isActive": true
      },
      "isClosed": false,
      "isPaused": false,
      "isUrgent": false,
      "deadlineStart": "2026-10-20T09:00:00.000Z",
      "deadlineEnd": "2026-10-27T18:00:00.000Z",
      "progress": 40,
      "complexity": 3,
      "createdAt": "2026-10-18T10:00:00.000Z",
      "updatedAt": "2026-10-25T14:30:00.000Z",
      "closedAt": null,
      "startedAt": "2026-10-19T08:00:00.000Z",
      "completedAt": null,
      "commentCount": 2,
      "status": null
    }
  ],
  "nextCursor": "eyJ1cGRhdGVkQXQiOiIyMDI2LTEwLTI1VDE0OjMwOjAwLjAwMFoiLCJpZCI6IjIyMjIyMjIyLTIyMjItNDIyMi04MjIyLTIyMjIyMjIyMjIyMiJ9",
  "limit": 2
}

Ошибки

КодКогдаПример тела
400Нет boardId или невалидный UUIDсм. ниже
401Нет / неверный / отозванный / просроченный токенсм. ниже
403Нет скоупа tasks:read или IP вне allowlistсм. ниже
429Rate limitсм. ниже
{
  "statusCode": 400,
  "message": ["boardId must be a UUID"],
  "error": "Bad Request"
}
{
  "statusCode": 401,
  "message": "Invalid or expired API token",
  "error": "Unauthorized"
}
{
  "statusCode": 403,
  "message": "Missing required API token scope: tasks:read",
  "error": "Forbidden"
}
{
  "statusCode": 403,
  "message": "Client IP is not allowed for this token",
  "error": "Forbidden"
}
{
  "statusCode": 429,
  "message": "Too Many Requests",
  "error": "Too Many Requests"
}

GET /tasks — колонка, автор, исполнитель, срочность, SLA

Запрос

GET /v1/tasks?boardId=33333333-3333-4333-8333-333333333333&columnId=44444444-4444-4444-8444-444444444444&authorId=11111111-1111-4111-8111-111111111111&assigneeId=11111111-1111-4111-8111-111111111112&isUrgent=true&slaStatus=on_time&search=Example&limit=50 HTTP/1.1
Host: api.aladdinhub.io
Authorization: Bearer ald_demoPrefix_mockSecretExampleOnly
Accept: application/json
curl -sS \
  -H "Authorization: Bearer ald_demoPrefix_mockSecretExampleOnly" \
  "https://api.aladdinhub.io/v1/tasks?boardId=33333333-3333-4333-8333-333333333333&columnId=44444444-4444-4444-8444-444444444444&authorId=11111111-1111-4111-8111-111111111111&assigneeId=11111111-1111-4111-8111-111111111112&isUrgent=true&slaStatus=overdue&limit=50"

Отдельные варианты slaStatus:

GET /v1/tasks?boardId=33333333-3333-4333-8333-333333333333&slaStatus=completed&limit=50 HTTP/1.1
GET /v1/tasks?boardId=33333333-3333-4333-8333-333333333333&slaStatus=on_time&limit=50 HTTP/1.1
GET /v1/tasks?boardId=33333333-3333-4333-8333-333333333333&slaStatus=overdue&limit=50 HTTP/1.1

Обычные (не срочные):

GET /v1/tasks?boardId=33333333-3333-4333-8333-333333333333&isUrgent=false&limit=50 HTTP/1.1

Ответ 200

Форма как у базового списка: { "data": [ … ], "nextCursor": null, "limit": 50 }.
Пустой результат: "data": [], "nextCursor": null.

Ошибки

Те же 401 / 403 / 429. Невалидный enum / UUID → 400:

{
  "statusCode": 400,
  "message": ["slaStatus must be one of the following values: completed, on_time, overdue"],
  "error": "Bad Request"
}

GET /tasks — точный день создания (createdOn)

Запрос

GET /v1/tasks?boardId=33333333-3333-4333-8333-333333333333&createdOn=2026-10-18&limit=50 HTTP/1.1
Host: api.aladdinhub.io
Authorization: Bearer ald_demoPrefix_mockSecretExampleOnly
Accept: application/json
curl -sS \
  -H "Authorization: Bearer ald_demoPrefix_mockSecretExampleOnly" \
  "https://api.aladdinhub.io/v1/tasks?boardId=33333333-3333-4333-8333-333333333333&createdOn=2026-10-18&limit=50"

Ответ 200

{
  "data": [
    {
      "id": "22222222-2222-4222-8222-222222222222",
      "title": "Example task title",
      "description": "Short mock description",
      "columnId": "44444444-4444-4444-8444-444444444444",
      "boardId": "33333333-3333-4333-8333-333333333333",
      "boardName": "Example board",
      "columnName": "In progress",
      "author": {
        "id": "11111111-1111-4111-8111-111111111111",
        "name": "Example Author",
        "role": "manager",
        "department": "tech",
        "team": "platform",
        "isActive": true
      },
      "assignee": null,
      "isClosed": false,
      "isPaused": false,
      "isUrgent": false,
      "deadlineStart": null,
      "deadlineEnd": null,
      "progress": 0,
      "complexity": null,
      "createdAt": "2026-10-18T10:00:00.000Z",
      "updatedAt": "2026-10-18T11:00:00.000Z",
      "closedAt": null,
      "startedAt": null,
      "completedAt": null,
      "commentCount": 0,
      "status": null
    }
  ],
  "nextCursor": null,
  "limit": 50
}

Ошибки

Общие 401 / 403 / 429. Неверный формат дня → 400:

{
  "statusCode": 400,
  "message": ["createdOn must match /^\\d{4}-\\d{2}-\\d{2}$/ regular expression"],
  "error": "Bad Request"
}

Комбинация createdOn + createdFrom → 400:

{
  "statusCode": 400,
  "message": "Do not combine createdOn with createdFrom/createdTo",
  "error": "Bad Request"
}

GET /tasks — диапазон обновлений (updatedFrom / updatedTo)

Запрос

GET /v1/tasks?boardId=33333333-3333-4333-8333-333333333333&updatedFrom=2026-10-20&updatedTo=2026-10-24&limit=50 HTTP/1.1
Host: api.aladdinhub.io
Authorization: Bearer ald_demoPrefix_mockSecretExampleOnly
Accept: application/json
curl -sS \
  -H "Authorization: Bearer ald_demoPrefix_mockSecretExampleOnly" \
  "https://api.aladdinhub.io/v1/tasks?boardId=33333333-3333-4333-8333-333333333333&updatedFrom=2026-10-20&updatedTo=2026-10-24&limit=50"

Ответ 200

Та же оболочка { data, nextCursor, limit }, что у базового списка (мок-элементы с updatedAt внутри окна).

Ошибки

Общие 401 / 403 / 429. Если updatedFrom > updatedTo → 400:

{
  "statusCode": 400,
  "message": "updatedFrom must be ≤ updatedTo",
  "error": "Bad Request"
}

Устаревший синоним нижней границы:

GET /v1/tasks?boardId=33333333-3333-4333-8333-333333333333&updatedSince=2026-10-26T12:00:00.000Z HTTP/1.1

GET /tasks — пересечение с дедлайном (deadlineFrom / deadlineTo)

Запрос

GET /v1/tasks?boardId=33333333-3333-4333-8333-333333333333&deadlineFrom=2026-10-20&deadlineTo=2026-10-26&limit=50 HTTP/1.1
Host: api.aladdinhub.io
Authorization: Bearer ald_demoPrefix_mockSecretExampleOnly
Accept: application/json
curl -sS \
  -H "Authorization: Bearer ald_demoPrefix_mockSecretExampleOnly" \
  "https://api.aladdinhub.io/v1/tasks?boardId=33333333-3333-4333-8333-333333333333&deadlineFrom=2026-10-20&deadlineTo=2026-10-26&limit=50"

Ответ 200

Как у списка; в выборку попадают только задачи, у которых интервал deadlineStart…deadlineEnd пересекается с окном. Без дедлайна — не включаются.

Ошибки

401 / 403 / 429; конфликт deadlineOn + deadlineFrom → 400 (как у created*).

GET /tasks — пагинация курсором

Запрос

GET /v1/tasks?boardId=33333333-3333-4333-8333-333333333333&limit=50&cursor=eyJ1cGRhdGVkQXQiOiIyMDI2LTEwLTI1VDE0OjMwOjAwLjAwMFoiLCJpZCI6IjIyMjIyMjIyLTIyMjItNDIyMi04MjIyLTIyMjIyMjIyMjIyMiJ9 HTTP/1.1
Host: api.aladdinhub.io
Authorization: Bearer ald_demoPrefix_mockSecretExampleOnly
Accept: application/json
curl -sS \
  -H "Authorization: Bearer ald_demoPrefix_mockSecretExampleOnly" \
  "https://api.aladdinhub.io/v1/tasks?boardId=33333333-3333-4333-8333-333333333333&limit=50&cursor=eyJ1cGRhdGVkQXQiOiIyMDI2LTEwLTI1VDE0OjMwOjAwLjAwMFoiLCJpZCI6IjIyMjIyMjIyLTIyMjItNDIyMi04MjIyLTIyMjIyMjIyMjIyMiJ9"

Ответ 200

{
  "data": [],
  "nextCursor": null,
  "limit": 50
}

(если страница пустая / последняя). При наличии ещё данных nextCursor — непустая opaque-строка.

Невалидный cursor игнорируется (эквивалент первой страницы), не 400.

Ошибки

401 / 403 / 429 как у базового списка. limit вне 1…100 → 400.

GET /tasks/{id} — карточка задачи

Запрос

GET /v1/tasks/22222222-2222-4222-8222-222222222222 HTTP/1.1
Host: api.aladdinhub.io
Authorization: Bearer ald_demoPrefix_mockSecretExampleOnly
Accept: application/json
curl -sS \
  -H "Authorization: Bearer ald_demoPrefix_mockSecretExampleOnly" \
  "https://api.aladdinhub.io/v1/tasks/22222222-2222-4222-8222-222222222222"

Ответ 200

{
  "id": "22222222-2222-4222-8222-222222222222",
  "title": "Example task title",
  "description": "Short mock description",
  "columnId": "44444444-4444-4444-8444-444444444444",
  "boardId": "33333333-3333-4333-8333-333333333333",
  "boardName": "Example board",
  "columnName": "In progress",
  "author": {
    "id": "11111111-1111-4111-8111-111111111111",
    "name": "Example Author",
    "role": "manager",
    "department": "tech",
    "team": "platform",
    "isActive": true
  },
  "assignee": {
    "id": "11111111-1111-4111-8111-111111111112",
    "name": "Example Assignee",
    "role": "developer",
    "department": "tech",
    "team": "platform",
    "isActive": true
  },
  "isClosed": false,
  "isPaused": false,
  "isUrgent": false,
  "deadlineStart": "2026-10-20T09:00:00.000Z",
  "deadlineEnd": "2026-10-27T18:00:00.000Z",
  "progress": 40,
  "complexity": 3,
  "createdAt": "2026-10-18T10:00:00.000Z",
  "updatedAt": "2026-10-25T14:30:00.000Z",
  "closedAt": null,
  "startedAt": "2026-10-19T08:00:00.000Z",
  "completedAt": null,
  "commentCount": 1,
  "status": null,
  "descriptionBlocks": [
    {
      "id": "55555555-5555-4555-8555-555555555555",
      "order": 0,
      "content": "Mock description block",
      "type": "text"
    }
  ],
  "comments": [
    {
      "id": "66666666-6666-4666-8666-666666666666",
      "content": "Mock comment body",
      "createdAt": "2026-10-20T12:00:00.000Z",
      "updatedAt": "2026-10-20T12:00:00.000Z",
      "author": {
        "id": "11111111-1111-4111-8111-111111111112",
        "name": "Example Assignee",
        "role": "developer",
        "department": "tech",
        "team": "platform",
        "isActive": true
      },
      "parentId": null
    }
  ]
}

Файлы и история правок не отдаются.

Ошибки

КодКогдаПример тела
401токенкак выше
403скоуп / IPкак выше
404нет задачи или не видна субъектуниже
429rate limitкак выше
{
  "statusCode": 404,
  "message": "Task not found",
  "error": "Not Found"
}

Разделы (boards:read)

GET /v1/departments и GET /v1/departments/{code}/boards — иерархия раздел → доски.

Доски (boards:read)

GET /v1/boards, GET /v1/boards/{id} и GET /v1/boards/{boardId}/tasks.

On this page

Задачи (tasks:read)GET /tasks — список (базовый, с доской)ЗапросОтвет 200ОшибкиGET /tasks — колонка, автор, исполнитель, срочность, SLAЗапросОтвет 200ОшибкиGET /tasks — точный день создания (createdOn)ЗапросОтвет 200ОшибкиGET /tasks — диапазон обновлений (updatedFrom / updatedTo)ЗапросОтвет 200ОшибкиGET /tasks — пересечение с дедлайном (deadlineFrom / deadlineTo)ЗапросОтвет 200ОшибкиGET /tasks — пагинация курсоромЗапросОтвет 200ОшибкиGET /tasks/{id} — карточка задачиЗапросОтвет 200Ошибки