Aladdin Public API

Пагинация

GET со cursor и limit — примеры и ошибки.

Пагинация

Используется в GET /v1/tasks и GET /v1/users.

{
  "data": [],
  "nextCursor": "…",
  "limit": 50
}
  • limit по умолчанию 50, максимум 100.
  • Следующая страница: тот же GET с ?cursor=<nextCursor>.
  • Фильтры задач: boardId, columnId, search, даты.

Пример: первая страница задач

Запрос

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

Ответ 200

{
  "data": [
    {
      "id": "22222222-2222-4222-8222-222222222222",
      "title": "Example task title",
      "updatedAt": "2026-10-25T14:30:00.000Z"
    }
  ],
  "nextCursor": "eyJ1cGRhdGVkQXQiOiIyMDI2LTEwLTI1VDE0OjMwOjAwLjAwMFoiLCJpZCI6IjIyMjIyMjIyLTIyMjItNDIyMi04MjIyLTIyMjIyMjIyMjIyMiJ9",
  "limit": 2
}

Пример: следующая страница

Запрос

GET /v1/tasks?boardId=33333333-3333-4333-8333-333333333333&limit=2&cursor=eyJ1cGRhdGVkQXQiOiIyMDI2LTEwLTI1VDE0OjMwOjAwLjAwMFoiLCJpZCI6IjIyMjIyMjIyLTIyMjItNDIyMi04MjIyLTIyMjIyMjIyMjIyMiJ9 HTTP/1.1
Host: api.aladdinhub.io
Authorization: Bearer ald_demoPrefix_mockSecretExampleOnly

Ответ 200

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

Ошибки

{
  "statusCode": 400,
  "message": ["limit must not be greater than 100"],
  "error": "Bad Request"
}

401 / 403 / 429 — Ошибки. Полные тела ответов задач/сотрудников: Задачи, Сотрудники.