← Документація

API

API Saykeeper надає скриптам і асистентам доступ до читання ваших зустрічей. Ключ може читати й ставити запитання, але нічого не може створювати, змінювати чи видаляти.

Ключі API

Створіть ключ у застосунку: «Налаштування», «API та MCP», «Ключі API». Дайте йому назву.
Ключ показується один раз. Saykeeper зберігає лише його хеш SHA-256, тому втрачений ключ не можна показати знову. Відкличте його та створіть новий.
Ключі починаються з ntb_live_. Не вставляйте їх в URL, репозиторії коду та спільні чати.

Авторизація

Надсилайте ключ у заголовку Authorization як токен Bearer. Кожен запит бачить лише зустрічі власника ключа.

Authorization: Bearer ntb_live_YOUR_KEY

Базова URL-адреса

https://api.saykeeper.com/v1

Ендпоінти, які приймають ключ API

Метод	Шлях	Що повертає
`GET`	`/meetings?limit=50`	Ваші зустрічі, від найновішої (макс. 200, ?archived=true для архівних).
`GET`	`/meetings/search?q=budget&limit=20`	Пошук у назвах і транскриптах (фільтри space_id, label_id, from, to).
`GET`	`/meetings/{id}`	Одна зустріч із транскриптом (спікери, час) і результатами ШІ.
`GET`	`/meetings/shared`	Зустрічі, якими з вами поділилися інші.
`GET`	`/meetings/report`	Рядок на кожну зустріч зі спікерами, для звітів.
`GET`	`/meetings/{id}/chat`	Запитання та відповіді, збережені до зустрічі.
`POST`	`/meetings/{id}/chat`	Запитання до однієї зустрічі. Тіло {"message":"..."}.
`GET`	`/meetings/{id}/clips`	Кліпи, вирізані із зустрічі.
`GET`	`/labels`	Ваші мітки.
`GET`	`/settings`	Ваші налаштування, зокрема мова транскрипту та нотаток.
`POST`	`/mcp`	Сервер MCP (JSON-RPC через Streamable HTTP).

Запис, завантаження, зміна чи видалення зустрічей, зміна налаштувань, а також керування ключами й вебхуками потребують застосунку з виконаним входом і у відповідь на ключ повертають 403 session_required.

Приклади

Останні зустрічі

curl "https://api.saykeeper.com/v1/meetings?limit=5" \
  -H "Authorization: Bearer ntb_live_YOUR_KEY"

Пошук

curl "https://api.saykeeper.com/v1/meetings/search?q=budget" \
  -H "Authorization: Bearer ntb_live_YOUR_KEY"

Одна зустріч із транскриптом і нотатками

curl "https://api.saykeeper.com/v1/meetings/MEETING_ID" \
  -H "Authorization: Bearer ntb_live_YOUR_KEY"

Запитання про зустріч

curl -X POST "https://api.saykeeper.com/v1/meetings/MEETING_ID/chat" \
  -H "Authorization: Bearer ntb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"What did we agree on?"}'

Помилки

`400`	Недійсні вхідні дані, наприклад непідтримуваний код мови (`unsupported_language`).
`401`	Відсутній або недійсний ключ (`missing_bearer_token`, `invalid_api_key`).
`403`	Потрібен застосунок із виконаним входом (`session_required`) або це не ваша зустріч.
`404`	Не знайдено.
`409`	У зустрічі ще немає транскрипту (`no_transcript`).
`429`	Перевищено ліміт частоти запитів (`rate_limited`). Зачекайте й спробуйте ще раз.

Обмеження частоти запитів

Що	Ліміт
Запитання до зустрічі (POST /meetings/{id}/chat)	20 / хвилину
MCP ask_meeting і ask_meetings	20 / хвилину

Вебхуки

Saykeeper може викликати вашу URL-адресу, коли зустріч готова. Додавайте вебхуки в розділі «Налаштування», «API та MCP». Кожну доставку підписано секретом вебхука.