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

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

Навигация публичного API: раздел → доска → (колонка) → задачи.

Методы — только GET. Скоуп на этом шаге: boards:read.

Базовый URL: https://api.aladdinhub.io/v1
Заголовок: Authorization: Bearer ald_…

Без elevated_read отдаются только разделы, где субъект токена видит хотя бы одну доску. С elevated_read=true — весь активный каталог разделов. Неизвестный code не подменяется на tech/creative: список досок пустой.

`GET /departments` — список разделов

Запрос

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

Ответ `200`

{
  "data": [
    {
      "code": "tech",
      "name": "Технический отдел",
      "order": 0,
      "color": null,
      "icon": null
    },
    {
      "code": "creative",
      "name": "Креативный отдел",
      "order": 1,
      "color": null,
      "icon": null
    },
    {
      "code": "commercial",
      "name": "Коммерческий отдел",
      "order": 2,
      "color": null,
      "icon": null
    }
  ]
}

Ошибки

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

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

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

`GET /departments/{code}/boards` — доски раздела

Запрос

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

Ответ `200`

{
  "data": [
    {
      "id": "33333333-3333-4333-8333-333333333333",
      "name": "Технический отдел",
      "department": "tech",
      "visibilityType": "open",
      "columns": [
        {
          "id": "44444444-4444-4444-8444-444444444441",
          "name": "Список задач",
          "order": 0,
          "type": "default"
        }
      ]
    }
  ]
}

Неизвестный код:

curl -sS \
  -H "Authorization: Bearer ald_demoPrefix_mockSecretExampleOnly" \
  -H "Accept: application/json" \
  "https://api.aladdinhub.io/v1/departments/unknown_section/boards"

{
  "data": []
}

Ошибки

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

Дальше: доски → GET /boards/{id} и GET /boards/{boardId}/tasks.

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

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

`GET /departments` — список разделов

Запрос

Ответ `200`

Ошибки

`GET /departments/{code}/boards` — доски раздела

Запрос

Ответ `200`

Ошибки

On this page