Розробникам · REST API

REST API і токени

Як видати токен доступу, звертатися до REST API Bordee, які є методи задач і що з вебхуками.

Токени доступу

Меню облікового запису (аватар внизу бічного меню) → «Токени доступу» → «Новий токен»:

Назва — для чого токен: «Синхронізація задач», «Claude Code на ноутбуці»;
Доступ — «Лише читання» або «Читання й зміни»;
Діє — 30 днів, 90 днів, рік або без строку.

Токен показується один раз — скопіюйте його одразу. «Відкликати» вимикає його миттєво. Адміністратор бачить і відкликає токени всіх співробітників.

Запити

Адреса — https://acme.bord.ee/api/v1/…, де acme — адреса вашого простору. Токен передається в заголовку Authorization: Bearer, відповіді — JSON. Ліміт — 120 запитів на хвилину на токен. Перший запит будь-якого клієнта — хто я:

curl https://acme.bord.ee/api/v1/me \
  -H "Authorization: Bearer $BORDEE_TOKEN" \
  -H "Accept: application/json"

Методи

Метод	Що робить
GET /api/v1/me	Власник токена, його роль і здібності токена
GET /api/v1/task-lists	Списки задач
GET /api/v1/task-fields	Власні поля задач і їхні варіанти
GET /api/v1/tasks	Пошук задач: list, status, assignee, contact, due (overdue, today, week), parent, external_ref, q, updated_since; per_page до 100
GET /api/v1/tasks/{id}	Задача з підзадачами
POST /api/v1/tasks	Нова задача
PATCH /api/v1/tasks/{id}	Змінити задачу
PUT /api/v1/task-lists/{list}/tasks/{ref}	Створити або оновити задачу за зовнішнім ключем
GET, POST /api/v1/tasks/{id}/comments	Коментарі задачі

Змінювати дані може лише токен з доступом «Читання й зміни». Методи модуля відповідають, поки модуль увімкнено. Контакти, угоди, розмови, воронки й розсилки вже доступні через MCP-сервер.

Приклади

Нова задача про контакт:

curl -X POST https://acme.bord.ee/api/v1/tasks \
  -H "Authorization: Bearer $BORDEE_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "title": "Передзвонити Ірині Коваль",
    "due_at": "2026-11-03T10:00:00+02:00",
    "priority": "high",
    "contact_id": 42
  }'

Відповідь:

{
  "data": {
    "id": 128,
    "title": "Передзвонити Ірині Коваль",
    "status": "open",
    "priority": "high",
    "due_at": "2026-11-03T08:00:00+00:00",
    "list": null,
    "contact": {"id": 42, "name": "Ірина Коваль"},
    "assignee": {"id": 3, "name": "Ім’я"},
    "external_ref": null,
    "custom": {},
    "url": "https://acme.bord.ee/manage/tasks/128"
  }
}

Синхронізація з іншою системою: PUT за зовнішнім ключем створює задачу, якщо її ще немає (201), або оновлює наявну (200). Підзадачу прив’язують полем parent_ref — ключем батьківської задачі в тому самому списку.

curl -X PUT https://acme.bord.ee/api/v1/task-lists/3/tasks/site-redesign \
  -H "Authorization: Bearer $BORDEE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "Новий дизайн сайту", "status": "open"}'

Зміни через API потрапляють у стрічку задачі з позначкою, яким токеном їх зроблено.

Вебхуки

Вебхуків назовні на події CRM (угоду виграно, контакт змінено) поки немає — вони заплановані. Приймати дані Bordee вже вміє: форми сайтів і Tilda надсилаються на адресу точки входу, див. Сайти, UTM і Conversions API.