文档 • API v2.4.0 企业版

Boostly 文档与 API

从第一个令牌到上线仅需 15 分钟：OAuth 2.0、REST 接口、HMAC-SHA256 签名 Webhook 与现成 SDK。下面是实时 API 控制台——切换接口与语言，点击“运行”。

1. 创建应用

注册并获取 client_id 与 client_secret，添加 redirect URI——令牌仅经官方 Meta* OAuth 2.0 发放。

2. 获取令牌

用 authorization code 换取 access token。长期令牌在到期前 7 天自动续期。

3. 找到话题并回复

调用 GET /v1/threads/search，用 POST /v1/replies/draft 生成草稿，经 approve 发布——或在 Telegram 确认。

API 控制台 playground

选择接口与语言——代码自动生成，点击“运行”返回模拟响应与延迟。

接口

响应

99.95% 可用性

过去 12 个月 API SLO

~120 毫秒

REST API 中位延迟（p50）

40+ 接口

话题、回复、广告、私信、数据分析

15 分钟

从注册到第一次 API 调用

平台能力

开箱即用的集成能力

认证、事件、限流与 SDK：集成的四大支柱。

OAuth 2.0 + scope

每个动作最小 scope，公开客户端用 PKCE，一次调用 DELETE /v1/tokens 吊销令牌。

签名 Webhook

每个事件经 HMAC-SHA256 签名（X-Hub-Signature-256），指数退避重试最长 24 小时。

透明的限流

限额经 X-RateLimit-* 头返回。自适应 4–9 分钟抖动让账号远离 Meta* 垃圾过滤器。

SDK 与 CLI

官方 Python、Go 与 TypeScript SDK + OpenAPI 3.1 规范，一分钟为您的技术栈生成客户端。

工程深潜

API 内部工作原理

让集成可预测的四项工程决策。

OAuth 2.0 认证

Authorization Code + PKCE。Scope：threads.read、replies.write、ads.moderate、dm.send。令牌存于 AES-256-GCM 保险库，续期对客户端透明。

Webhook 与 HMAC-SHA256

用 app secret 对 raw body 计算签名，用 timing-safe 比较校验，10 秒内返回 200——否则重试。

限流

每 key 600 次/分钟，每账号每日 35 次发布，发送间隔抖动 4–9 分钟。429 时返回 Retry-After 并由我方排队。

SDK-first 理念

OpenAPI 3.1 → 自动生成客户端。SDK 开箱即支持重试、令牌刷新与日志 PII 脱敏。

接口一览

核心 REST API：方法、路径与用途。

方法	路径	说明
GET	/v1/threads/search	带意向评分的热门话题语义搜索。
POST	/v1/replies/draft	用您的语气生成专家回复草稿。
POST	/v1/replies/approve	草稿审批：发布或进入 Telegram 队列。
GET	/v1/ads/comments	广告创意下的评论流。
POST	/v1/ads/comments/hide	Shadow-hide 垃圾信息：作者无感知。
POST	/v1/dm/send	向私信发送线索磁铁并做筛选。

Webhook 示例：新的热门话题

每次事件 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"])

错误码

所有错误均为含 code、message 与 retryable 字段的 JSON。

代码	含义	处理方法
400 invalid_scope	请求的 scope 超出 App Review	去掉多余 scope，对照文档
401 token_expired	令牌过期	刷新或重新走 OAuth
409 already_published	回复已发布	用 GET 查询状态而非重试
422 spam_suspect	被 Meta* 判为垃圾	增大抖动、降低频率
429 rate_limited	超出限流	遵守 Retry-After，启用队列

Boostly API vs 直连 Graph API vs 爬虫

为什么集成建在我们之上，而不是绕过我们。

维度	Boostly API	直连 / 爬虫
封号风险	0%：官方配额与抖动	高：手动限流与封号
Telegram 审批	内置：一键审批卡片	从零自建
反垃圾管理	Dark Post Shield 内置	仅手动隐藏
审计合规	日志、PII 脱敏、SIEM 导出	自行记录

今天就交付第一个集成

沙箱、OpenAPI 规范与 SDK——试用期内免费，15 分钟内发出第一条审批回复。

今天就交付第一个集成含沙箱 • 无需绑卡

v2.4.0开始 3 天免费试用

API 常见问题

在控制台注册应用：获取 client_id 与 client_secret，完成 OAuth 2.0。试用自带测试沙箱——沙箱密钥免费。

用 app secret 对 raw body 计算 HMAC-SHA256，与 X-Hub-Signature-256 做 timing-safe 比较，示例见上文 Webhook 部分。

每 key 每分钟 600 次，每账号每日最多 35 次发布，发送间隔抖动 4–9 分钟，限额见 X-RateLimit-* 头。

官方 Python、Go 与 TypeScript SDK，另有 OpenAPI 3.1 规范可生成任意语言客户端，示例见控制台标签页。

遵守 Retry-After 并排队——SDK 会自动处理。不要暴力重试：那是直通 Meta* 封号的快车道。

可以：DELETE /v1/tokens/{id} 即刻吊销。登录异常时自动吊销自行触发，并经 Telegram 告警。