把内容 Agent 接进你的系统

快速开始

curl -H "Authorization: Bearer svt_你的Key" \
  https://sarasvati.cn/api/v1/me

{
  "ok": true,
  "data": {
    "tenantId": 5,
    "name": "路信通",
    "plan": "pro",
    "certifiedUntil": "2027-09-01T00:00:00.000Z",
    "balanceUnits": 2000,
    "status": "active",
    "unitCosts": { "rewritePerArticle": 20, "imagePerPiece": 5, "eoReport": 30 }
  }
}

通用约定

Base URL 与认证

响应格式

成功统一返回 { "ok": true, "data": … }；列表接口额外带分页字段；失败统一返回 { "ok": false, "error": "错误说明" } 并配对应 HTTP 状态码。

分页

列表接口统一支持 page（从 1 开始）与 limit（默认 20，最大 100）两个 query 参数。

错误码

GET/api/v1/me

验证 Key 并返回账号概要：名称、认证档位、到期时间、单元余额与各项单元单价。

响应字段

示例

curl -H "Authorization: Bearer svt_你的Key" \
  https://sarasvati.cn/api/v1/me

GET/api/v1/topics

选题清单：Agent 根据你的信源与品牌综合研判后产出的选题，按创建时间倒序。

请求参数

响应字段（data 数组项）

示例

curl -H "Authorization: Bearer svt_你的Key" \
  "https://sarasvati.cn/api/v1/topics?status=proposed&limit=10"

{
  "ok": true,
  "data": [
    {
      "id": 128,
      "title": "国庆假期高速出行预测与避堵指南",
      "status": "proposed",
      "score": 86,
      "source": "tavily-hot",
      "brand": { "id": 3, "name": "路信通" },
      "manuscriptId": null,
      "createdAt": "2026-09-25T09:12:00.000Z",
      "updatedAt": "2026-09-25T09:12:00.000Z"
    }
  ],
  "page": 1, "limit": 10, "total": 1, "hasNext": false
}

GET/api/v1/manuscripts

稿件列表：一篇稿件含多个平台适配版本，每个版本的发布状态、作品链接、失败原因都独立返回。

请求参数

响应字段（data 数组项）

platforms 数组项

示例

curl -H "Authorization: Bearer svt_你的Key" \
  "https://sarasvati.cn/api/v1/manuscripts?status=published&limit=5"

GET/api/v1/manuscripts/{id}

稿件详情：字段与列表一致，额外返回摘要与各平台版本的完整正文。稿件不存在或不属于当前账号时返回 404。

额外返回字段

示例

curl -H "Authorization: Bearer svt_你的Key" \
  https://sarasvati.cn/api/v1/manuscripts/57

GET/api/v1/effects

效果回采数据：已发布作品的查看、点赞、回复、分享。同一作品会被定期多次回采，每次回采一条记录——按时间排起来就是增长曲线。

请求参数

响应字段（data 数组项）

示例

curl -H "Authorization: Bearer svt_你的Key" \
  "https://sarasvati.cn/api/v1/effects?days=30&limit=50"

{
  "ok": true,
  "data": [
    {
      "manuscriptId": 57,
      "manuscriptTitle": "智慧公路的三个误区",
      "brand": { "id": 3, "name": "路信通" },
      "platform": "zhihu",
      "publishedUrl": "https://zhuanlan.zhihu.com/p/…",
      "views": 1286, "likes": 45, "comments": 7, "shares": 3,
      "fetchedAt": "2026-09-26T02:00:00.000Z",
      "error": null
    }
  ],
  "page": 1, "limit": 50, "total": 1, "hasNext": false, "days": 30
}

POST/api/v1/directives

提交内容需求指令。指令创建为「待确认」状态——本接口不扣单元，你在控制台「指令」页确认后，才按与手动创建完全相同的流程解析、计费、执行。

请求体（JSON）

响应字段

示例

curl -X POST -H "Authorization: Bearer svt_你的Key" \
  -H "Content-Type: application/json" \
  -d '{"rawText":"本周给路信通出 3 篇行业热点图文，发知乎和公众号","brandId":3}' \
  https://sarasvati.cn/api/v1/directives

{
  "ok": true,
  "data": {
    "directiveId": 42,
    "status": "pending_confirm",
    "confirmUrl": "https://sarasvati.cn/console/directives"
  }
}

典型场景

安全与配额

• Key 只存哈希：服务端只保存 Key 的 SHA-256，完整 Key 无法被找回——生成时务必立即保存，丢失请重置。
• 数据隔离：每个 Key 只能访问所属账号的数据；跨账号资源一律返回 404，不暴露存在性。
• 停用即失效：账号停用（如到期未续费）后 Key 同步失效，恢复后无需重新生成。
• 吊销与重置：怀疑泄露时在「我的」页点「吊销」立即失效；「重置」生成新 Key 同时作废旧 Key。
• 写操作保护：目前唯一的写接口（提交指令）创建后仍为「待确认」，不会产生任何扣费，杜绝程序异常刷量。
• 频率建议：常规轮询建议不低于 1 分钟一次；列表接口单页最大 100 条，请用分页遍历。

常见问题

开发者支持

接入中遇到任何问题，有三条通道——优先提工单，响应最快：

路线图

• 发布操作类接口：指定渠道直接发布 / 失败稿件重新发布
• Webhook 回调：稿件待审批、发布完成、效果更新时主动推送到你的服务
• 细粒度 Key 权限：只读 / 读写分离，多 Key 管理
• API 用量统计：控制台可视化的调用量与错误率

有接口需求？在控制台「工单」里提，被采纳有单元奖励。