问题
当前 OpenAPI v2 在订阅源管理上存在不对称:
- ✅
POST /openapi/v2/me/onboarding/follow — 批量关注
- ❌ 没有 unfollow / 取消关注端点
- ❌ CLI 也缺少对应命令
网页端 proxy API 实际已有 DELETE /api/proxy/users/me/subscriptions/{sourceId},但仅限 Session Cookie 鉴权,API Key 无法使用。
影响
- Agent / CLI 用户无法通过 API 管理订阅源生命周期
- 只能 follow 不能 unfollow,违背 CRUD 完整性
- 网页端手动操作与 API 自动化之间存在断层
建议方案
新增端点,与 follow 对称:
DELETE /openapi/v2/me/onboarding/follow
请求体:
{
"sourceIds": ["SOURCE_xxx", "SOURCE_yyy"]
}
响应:
{
"success": true,
"data": {
"requestedCount": 2,
"successCount": 2,
"notSubscribedCount": 0,
"failedCount": 0
}
}
CLI 侧同步添加:
bestblogs intake unfollow --source-ids SOURCE_xxx,SOURCE_yyy
备注
- 鉴权方式保持
X-API-KEY header
- 语义上幂等:对已取消关注的源返回
notSubscribedCount 而非报错
- 网页端已有的 proxy 端点证明后端逻辑已就绪,主要是 API 层的暴露问题
问题
当前 OpenAPI v2 在订阅源管理上存在不对称:
POST /openapi/v2/me/onboarding/follow— 批量关注网页端 proxy API 实际已有
DELETE /api/proxy/users/me/subscriptions/{sourceId},但仅限 Session Cookie 鉴权,API Key 无法使用。影响
建议方案
新增端点,与 follow 对称:
请求体:
{ "sourceIds": ["SOURCE_xxx", "SOURCE_yyy"] }响应:
{ "success": true, "data": { "requestedCount": 2, "successCount": 2, "notSubscribedCount": 0, "failedCount": 0 } }CLI 侧同步添加:
备注
X-API-KEYheadernotSubscribedCount而非报错