Быстрый старт

Bordio API даёт вам программный доступ к вашему воркспейсу — задачам, событиям, проектам и определениям — через простой REST-интерфейс.

1. Получите API-ключ

Создайте секретный ключ в настройках вашего воркспейса Bordio. Каждый ключ имеет scope: чтение или чтение-запись, по всему воркспейсу или одному проекту. Ключи выглядят как brd_sk_live_….

2. Сделайте первый запрос

Отправьте ключ как bearer-токен. Самый короткий запрос сразу показывает, к какому воркспейсу привязаны ваши учётные данные:

curl https://api.bordio.com/public/v1/workspace \
  -H "Authorization: Bearer brd_sk_live_..."

Успешный ответ оборачивается в обёртку data:

{
  "data": {
    "id": "ws_6594a1b2c3d4e5f6a7b8c9e1",
    "name": "Acme Inc.",
    "timezone": "Europe/Berlin",
    "created_at": "2026-06-25T10:00:00.000Z"
  }
}

Списочные эндпоинты оборачиваются так же и добавляют блок pagination:

curl https://api.bordio.com/public/v1/tasks \
  -H "Authorization: Bearer brd_sk_live_..."

{
  "data": [
    { "id": "task_6a2918cff58b0a1d387866ee", "title": "Ship the API", "priority": "high" }
  ],
  "pagination": { "next_cursor": null, "has_more": false }
}

3. Дальнейшие шаги

Аутентификация — ключи, scope и заголовки.
Соглашения — обёртки, пагинация, идемпотентность.
Ошибки — как сообщается об ошибках.
Справочник API — каждый эндпоинт со встроенным средством запуска запросов.