99.95% uptime
SLO API за последние 12 месяцев
Docs • API v2.4.0 Enterprise
Документация и API Boostly
От первого токена до production за 15 минут: OAuth 2.0, REST-эндпоинты, вебхуки с подписью HMAC-SHA256 и готовые SDK. Ниже — живая API-консоль: переключайте эндпоинты и языки, жмите «Выполнить».
1. Создайте приложение
Зарегистрируйтесь, получите client_id и client_secret. Добавьте redirect URI — токены выдаются только через официальный OAuth 2.0 Meta*.
2. Получите токен
Обменяйте authorization code на access token. Long-lived токены продлеваются автоматически за 7 дней до истечения.
3. Найдите тред и ответьте
Вызовите GET /v1/threads/search, сгенерируйте черновик POST /v1/replies/draft и опубликуйте через approve — или подтвердите в Telegram.
API-консоль playground
Выберите эндпоинт и язык — код соберётся сам. Кнопка «Выполнить» вернёт фейковый ответ с латентностью.
Ответ
~120 мс
медианная латентность REST API (p50)
40+ эндпоинтов
треды, ответы, реклама, DM, аналитика
15 минут
от регистрации до первого вызова API
Возможности платформы
Всё для интеграции — из коробки
Аутентификация, события, лимиты и SDK: четыре столпа, на которых строятся интеграции.
OAuth 2.0 + scopes
Минимальные scopes на каждое действие, PKCE для публичных клиентов, отзыв токена одним вызовом DELETE /v1/tokens.
Вебхуки с подписью
Каждое событие подписано HMAC-SHA256 (X-Hub-Signature-256). Ретраи с экспоненциальным backoff до 24 часов.
Честные rate limits
Лимиты возвращаются в заголовках X-RateLimit-*. Адаптивный джиттер 4–9 минут держит аккаунт вне спам-фильтров Meta*.
SDK и CLI
Официальные SDK для Python, Go и TypeScript + OpenAPI 3.1 спека. Сгенерируйте клиент под свой стек за минуту.
Engineering Deep Dive
Как устроен API внутри
Четыре инженерных решения, которые делают интеграции предсказуемыми.
Аутентификация OAuth 2.0
Authorization Code + PKCE. Scopes: threads.read, replies.write, ads.moderate, dm.send. Токены живут в vault AES-256-GCM, продление — прозрачно для клиента.
Вебхуки и HMAC-SHA256
Подпись считается от raw body вашим app secret. Сверяйте через timing-safe compare, отвечайте 200 в течение 10 секунд — иначе ретрай.
Rate limits
600 req/min на ключ, 35 публикаций/сутки на профиль, джиттер 4–9 минут между отправками. При 429 — заголовок Retry-After и очередь на нашей стороне.
SDK-first подход
OpenAPI 3.1 → автогенерация клиентов. SDK повторяют ретраи, обновляют токены и маскируют PII в логах из коробки.
Таблица эндпоинтов
Ядро REST API: метод, путь и назначение.
| Метод | Путь | Описание |
|---|---|---|
| GET | /v1/threads/search | Семантический поиск горячих тредов с intent-скорингом. |
| POST | /v1/replies/draft | Генерация черновика экспертного ответа вашим тоном. |
| POST | /v1/replies/approve | Одобрение черновика: публикация или очередь в Telegram. |
| GET | /v1/ads/comments | Поток комментариев под рекламными креативами. |
| POST | /v1/ads/comments/hide | Shadow-hide спама: автор не видит скрытия. |
| POST | /v1/dm/send | Отправка lead-магнита в Direct с квалификацией. |
Пример вебхука: новый горячий тред
Boostly стучится на ваш URL при каждом событии. Проверяйте подпись до обработки.
POST → https://ваш-домен/hooks/boostly • заголовок X-Hub-Signature-256
POST /hooks/boostly HTTP/1.1
X-Hub-Signature-256: sha256=9f2c…e41a
{
"event": "thread.hot",
"thread_id": "thr_8H2KQ",
"intent_score": 0.96,
"replies_18m": 48,
"lang": "ru"
}
import hmac, hashlib
sig = hmac.new(APP_SECRET, raw_body, hashlib.sha256).hexdigest()
ok = hmac.compare_digest("sha256=" + sig, request.headers["X-Hub-Signature-256"])
Коды ошибок
Все ошибки — JSON с полями code, message и retryable.
| Код | Значение | Что делать |
|---|---|---|
| 400 invalid_scope | Запрошен scope вне App Review | Уберите лишний scope, сверьтесь с доками |
| 401 token_expired | Токен истёк | Обновите через refresh или OAuth заново |
| 409 already_published | Ответ уже опубликован | Запросите GET статуса вместо повтора |
| 422 spam_suspect | Meta* отклонил как спам | Увеличьте джиттер, снизьте темп |
| 429 rate_limited | Превышен лимит | Подождите Retry-After, включите очередь |
Boostly API vs прямой Graph API vs скрапинг
Почему интеграции строят поверх нас, а не в обход.
| Критерий | Boostly API | Напрямую / скрапинг |
|---|---|---|
| Риск блокировки | 0%: официальные квоты и джиттер | Высокий: ручные лимиты и баны |
| Согласование в Telegram | Встроено: карточки approve в 1 клик | Писать самим с нуля |
| Антиспам-модерация | Dark Post Shield из коробки | Только ручной скрытие |
| Audit и compliance | Журнал, PII-маски, SIEM-экспорт | Логировать самим |
Соберите первую интеграцию сегодня
Sandbox, OpenAPI-спека и SDK — бесплатно в триале. Первый одобренный ответ — уже через 15 минут.
Соберите первую интеграцию сегодняSandbox включён • Без привязки карты
v2.4.0Начать 3 дня бесплатно
Частые вопросы по API
Зарегистрируйте приложение в дашборде: получите client_id и client_secret, пройдите OAuth 2.0. Тестовый sandbox включён в триал — ключи тестовой среды бесплатны.
Посчитайте HMAC-SHA256 от raw body вашим app secret и сравните с заголовком X-Hub-Signature-256 через timing-safe сравнение. Пример — в секции вебхуков выше.
600 запросов в минуту на ключ, до 35 публикаций в сутки на профиль, джиттер 4–9 минут между отправками. Лимиты видны в заголовках X-RateLimit-*.
Официальные SDK для Python, Go и TypeScript, плюс OpenAPI 3.1 спека для автогенерации под любой язык. Примеры — во вкладках консоли выше.
Прочитайте заголовок Retry-After и поставьте задачу в очередь — SDK делают это автоматически. Не долбите ретраями: это путь к бану у Meta*.
Да: DELETE /v1/tokens/{id} отзывает мгновенно. При аномалии входа автоотзыв срабатывает сам, владелец получает алерт в Telegram.