Швидкий старт API

Цей гайд проведе від нуля до першого успішного запиту: створити персональний токен, дізнатися базову адресу і викликати REST-ендпоінт.

Крок 1. Створити персональний токен

Відкрийте особистий кабінет, розділ персональних токенів, і створіть новий токен (PAT). Скопіюйте його значення одразу — воно показується один раз і починається з префікса mbp_. При створенні оберіть області доступу (scopes), достатні для вашого завдання; детальніше у гайді з авторизації.

Крок 2. Базова адреса і формат

Усі REST-ендпоінти живуть під префіксом /api. Версіонування в шляху немає. Тіла запитів і відповідей — JSON; передавайте заголовок Content-Type: application/json для запитів із тілом. Токен передається заголовком Authorization: Bearer mbp_….

Крок 3. Перший запит — список ботів

Перевірте токен запитом списку ваших ботів. Для цього потрібен scope bots:read (або *):

curl -H "Authorization: Bearer mbp_ВАШ_ТОКЕН" https://ваш-домен/api/bots

У відповідь прийде JSON-масив ботів. Якщо токен невірний або прострочений — повернеться 401 з тілом {"error":"..."} (див. помилки).

Крок 4. Перша мутація — створити реакцію

Створення реакції потребує scope reactions:write. Підставте ідентифікатор бота з кроку 3:

curl -X POST -H "Authorization: Bearer mbp_ВАШ_ТОКЕН" -H "Content-Type: application/json" -d '{"name":"Привіт","trigger":{"type":"command","value":"/start"}}' https://ваш-домен/api/bots/BOT_ID/reactions

Успішна відповідь поверне створену реакцію з її id. Точні поля тіла дивіться в інтерактивному довіднику — він генерує готові приклади на curl, JavaScript і Python для кожного ендпоінта.

Крок 5. Далі — за довідником

Коли токен працює, решту зручніше вивчати в інтерактивному довіднику: там видно повний список ендпоінтів, необхідні scopes, схеми тіл і кнопка «Try it».

Що далі