Skip to content

[Feature Request] OpenAPI v2: 添加取消关注(unfollow)端点 #81

Description

@YouToco

问题

当前 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 层的暴露问题

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions