API 文档
接口说明
GET /api/external/v1/daily-briefing-
鉴权请求头：
X-API-Key: <your-key> - 推荐给 skills 使用单领域 + 小 limit，优先减少 token 消耗。
查询参数
| 参数 | 说明 |
|---|---|
date |
可选，格式 YYYY-MM-DD；不传则返回最新批次。 |
domain |
可选：physics、math、cs、q-bio、econ、astro-ph。 |
limit |
可选，范围 1..24；建议传 3 或 5。 |
lang |
可选：zh 或 en，默认 zh。 |
返回重点字段
- batchDate：当前返回的数据批次日期。
- status：ready、partial、empty。
- domains[].digest：该领域 AI 导读。
- domains[].cards：该领域速览卡片数组。
- 配额响应头：X-Quota-Limit、X-Quota-Remaining、X-Quota-Reset-At。
示例请求
示例请求会跟随当前页面语言切换：英文页默认展示 lang=en，中文页默认展示 lang=zh。
curl -H "X-API-Key: <your-key>" "https://fortunescent.com/api/external/v1/daily-briefing?lang=zh"
curl -H "X-API-Key: <your-key>" "https://fortunescent.com/api/external/v1/daily-briefing?domain=physics&limit=5&lang=zh"
错误码与建议
| 状态码 | 含义 |
|---|---|
400 |
请求参数不合法，如 domain 或 limit 错误。 |
401 |
缺少 API Key 或 API Key 无效。 |
403 |
client 被停用。 |
404 |
指定日期暂无对应批次。 |
429 |
超过日配额或申请接口触发防刷限制。 |
- skills 优先传 domain。
- limit 建议使用 3 或 5。
- 明文 API Key 只会在成功页展示一次。
- 旧的邮箱验证接口已废弃，当前申请为直发模式。