Доски (`boards:read` / `tasks:read`)

Методы — только GET. POST / PATCH / DELETE в публичном API нет.

Базовый URL: https://api.aladdinhub.io/v1
Список и карточка доски: скоуп boards:read
Задачи доски: скоуп только tasks:read
Заголовок: Authorization: Bearer ald_…

Сначала разделы: Разделы.

`GET /boards` — список досок

Запрос

GET /v1/boards 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/boards"

Ответ `200`

{
  "data": [
    {
      "id": "33333333-3333-4333-8333-333333333333",
      "name": "Example board",
      "department": "tech",
      "visibilityType": "department",
      "columns": [
        {
          "id": "44444444-4444-4444-8444-444444444441",
          "name": "Backlog",
          "order": 0,
          "type": "default"
        },
        {
          "id": "44444444-4444-4444-8444-444444444444",
          "name": "In progress",
          "order": 1,
          "type": "default"
        }
      ]
    }
  ]
}

В списке нет вложенных карточек задач — только колонки.

Ошибки

Код	Когда	Пример тела
`401`	токен	ниже
`403`	нет `boards:read` или IP	ниже
`429`	rate limit	ниже

{
  "statusCode": 401,
  "message": "Invalid or expired API token",
  "error": "Unauthorized"
}

{
  "statusCode": 403,
  "message": "Missing required API token scope: boards: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 /boards/{id}` — одна доска

Запрос

GET /v1/boards/33333333-3333-4333-8333-333333333333 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/boards/33333333-3333-4333-8333-333333333333"

Ответ `200`

{
  "id": "33333333-3333-4333-8333-333333333333",
  "name": "Example board",
  "department": "tech",
  "visibilityType": "department",
  "columns": [
    {
      "id": "44444444-4444-4444-8444-444444444441",
      "name": "Backlog",
      "order": 0,
      "type": "default"
    },
    {
      "id": "44444444-4444-4444-8444-444444444444",
      "name": "In progress",
      "order": 1,
      "type": "default"
    }
  ]
}

Ошибки

401 / 403 / 429 — как у списка. Не найдена / не видна субъекту → 404:

{
  "statusCode": 404,
  "message": "Board not found",
  "error": "Not Found"
}

`GET /boards/{boardId}/tasks` — задачи доски

Скоуп: tasks:read (достаточно одного; boards:read не требуется). Фильтры те же, что у GET /tasks: columnId, authorId, assigneeId, isUrgent, slaStatus, даты, cursor, limit. boardId берётся из пути.

Запрос

GET /v1/boards/33333333-3333-4333-8333-333333333333/tasks?createdFrom=2026-10-19&createdTo=2026-10-25&limit=100 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/boards/33333333-3333-4333-8333-333333333333/tasks?createdFrom=2026-10-19&createdTo=2026-10-25&limit=100"

Ответ `200`

{
  "data": [
    {
      "id": "11111111-1111-4111-8111-111111111111",
      "title": "Example task",
      "description": null,
      "columnId": "44444444-4444-4444-8444-444444444441",
      "boardId": "33333333-3333-4333-8333-333333333333",
      "boardName": "Технический отдел",
      "columnName": "Список задач",
      "author": {
        "id": "22222222-2222-4222-8222-222222222222",
        "name": "Example Author",
        "role": "tech_specialist",
        "department": "tech",
        "team": null,
        "isActive": true
      },
      "assignee": {
        "id": "55555555-5555-4555-8555-555555555555",
        "name": "Example Assignee",
        "role": "tech_specialist",
        "department": "tech",
        "team": null,
        "isActive": true
      },
      "isClosed": false,
      "isPaused": false,
      "isUrgent": false,
      "deadlineStart": null,
      "deadlineEnd": null,
      "progress": 0,
      "complexity": null,
      "createdAt": "2026-10-20T12:00:00.000Z",
      "updatedAt": "2026-10-21T09:00:00.000Z",
      "closedAt": null,
      "startedAt": null,
      "completedAt": null,
      "commentCount": 0,
      "status": null
    }
  ],
  "nextCursor": null,
  "limit": 100
}

Ошибки

Код	Когда
`401`	токен
`403`	нет `tasks:read` или IP
`404`	доска не найдена (или не видна без elevated)
`429`	rate limit

{
  "statusCode": 403,
  "message": "Missing required scope(s): tasks:read",
  "error": "Forbidden"
}

Доски (boards:read)

Доски (`boards:read` / `tasks:read`)

`GET /boards` — список досок

Запрос

Ответ `200`

Ошибки

`GET /boards/{id}` — одна доска

Запрос

Ответ `200`

Ошибки

`GET /boards/{boardId}/tasks` — задачи доски

Запрос

Ответ `200`

Ошибки

On this page