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

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

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

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

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

Отправьте ключ как bearer-токен:

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

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

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

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

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