API 开发与系统集成技术方案

以下架构、代码、账号与监测记录为设计示意，其中数字与响应为示意数据，不代表真实客户交付或性能实测。实际范围与性能须按项目实现和验收。

API 项目先确认四项设计输入

模块选择见API 开发服务；把设计输入写入联调与验收流程后，再估算开发投入。以下内容系统架构按具体业务裁剪。

系统分层

这套结构用于说明方案分层，实际模块按业务与监测范围裁剪。

数据模型

核心只有四张表：account、content、task、result。 内容与平台解耦，平台差异放在 task.payload 里，新增平台不改主表。

发布队列与频控

队列按 account_id + platform 分区：同一账号串行，避免自己把自己限流；不同账号并发，保证吞吐。 频控用令牌桶，按平台配置 QPS，429 时读 Retry-After 退避。

for task in queue.consume(partition = account_id):
    token = limiter.acquire(account_id, platform)
    result = adapter.publish(task, token)

    if result.retryable:
        queue.retry(task, delay = backoff(task.attempt))
    elif result.success:
        store.save(task, result.platform_post_id)
        events.emit("content.published", task, result)
    else:
        store.fail(task, result.error_code)
        events.emit("content.failed", task, result)

幂等与重试

• 幂等键：由业务生成（如 content_id + account_id 的哈希），24 小时内重复请求只建一个任务。
• 可重试：网络超时、平台 5xx、429。指数退避 1s / 2s / 4s，最多 3 次。
• 不可重试：参数错误、权限不足、内容违规。直接落库为 failed，附带平台原始返回。
• 状态机：queued → publishing → reviewing → success / failed，晚到的 reviewing 不能覆盖 success。

接口长什么样

POST /v1/content/publish
Authorization: Bearer <;service-token>;
Idempotency-Key: 7b1f9c2e-4a11-4c2e-9f3c

{
  "platform": "zhihu",
  "account_id": "acc_8f21",
  "content_type": "article",
  "title": "AI 搜索时代，内容分发怎么做",
  "body": "...",
  "body_format": "markdown",
  "publish_at": "2026-10-24T09:00:00+08:00"
}

完整参数与响应见 接口设计样例。

收录与引用监测

这是最容易「看起来很美」的部分。我们的原则是：数据源分开标注，缺失不补零。

• 收录：优先走百度 / 必应的公开查询，拿不到的用站内搜索抽检。
• AI 引用：固定问题集，每天 2–3 个时段向公开问答入口提问，记录品牌 / 链接 / 观点是否出现及位置，多次取并集。

{
  "question_id": "q_1024",
  "runs": [
    { "engine": "chatgpt", "at": "2026-10-21T09:00:00Z", "cited": true,  "position": 2 },
    { "engine": "chatgpt", "at": "2026-10-21T15:00:00Z", "cited": false, "position": null },
    { "engine": "doubao",  "at": "2026-10-21T09:10:00Z", "cited": true,  "position": 1 }
  ],
  "sample_size": 3,
  "cited_runs": 2
}

安全与合规

• 账号凭证 AES-256 加密存储，密钥与数据分离；不提供明文导出接口。
• 全链路操作审计：谁、什么时候、对哪个账号、发了什么。
• 不收集账号密码、不模拟登录、不绕过平台风控。
• 客户数据按租户隔离，权限最小化；数据保留、删除和备份清理方式按项目确认。

部署形态

三种常见形态，按你的合规要求选：

技术常见问题