这一篇讲带密钥的个人订阅接口与两个公共扩展端点。这个能干什么：把「我的关注」「我的推送规则」的命中内容接到你自己的 RSS 阅读器、机器人或脚本里，也可以零门槛订阅全站 RSS。需要什么：个人接口要登录后生成的 uid + 密钥；公共 RSS 和榜单不需要任何凭证。

它们和 /api/v1 公共接口的差别：公共接口取的是全站数据，个人接口按你的账号输出你自己的内容（你的关注位规则、你的推送规则命中）。

一、两种凭证，先分清

类型	怎么拿	适合
个人密钥接口（本篇前两节）	登录后在我的关注设置 / 信息推送设置点「订阅地址」生成，uid + k 两个参数即是凭证	订阅你自己的关注命中流、推送命中流
公共无凭证接口（本篇后两节）	不需要任何密钥，直接 GET	RSS 订阅全站/分类内容、读取榜单 JSON

密钥是一串 32 位十六进制字符，泄露等于别人能看到你的订阅内容——发现泄露或想作废旧地址，回设置页点「重置密钥」即可，旧地址立即失效。

二、我的关注命中流（个人）

GET https://new.xianbao.fun/plus/json/guanzhu_feed.php?uid=你的ID&k=你的密钥

输出你「我的关注」三个关注位（规则行筛选口径与前台 /category-guanzhu1/ 等页面完全一致）的最新命中，按发布时间倒序合并。

参数	说明
uid	你的用户 ID（订阅地址里已带）
k	订阅密钥（与推送命中流共用同一把，重置后两边同时失效）
type	缺省 = RSS 2.0；type=json 得到 JSON
limit	条数 1–50，默认 30
id	可选 1/2/3，只取某个关注位；缺省合并三位

密钥入口：用户中心 → 我的关注设置 → 页面顶部「订阅地址」按钮（可生成、复制、重置）。没有生成过就先点一次生成，再复制完整地址。

JSON 返回结构（RSS 为标准 RSS 2.0，条目字段一致）：

{ "code": 1, "count": 3, "updated": 1760000000,
  "list": [ { "id": 7243360, "is_zdm": 0, "title": "…", "catename": "好单线报-食品-京东",
              "louzhu": "发报员Z", "url": "https://new.xianbao.fun/haodan/7243360.html", "time": 1760000000 } ] }

值得买来源条目 is_zdm=1、url 为值得买原文外链，louzhu 为空。整包缓存约 5 分钟（改了关注规则最多 5 分钟才反映）；本端点限流 60 次/分钟/IP，响应带 X-RateLimit-* 头，超限 JSON 返回 {"code":0,"msg":"请求过于频繁…"}、RSS 返回 HTTP 429。

三、推送命中流（个人）

GET https://new.xianbao.fun/zb_users/plugin/xbpush/api/feed.php?uid=你的ID&k=你的密钥[&type=json][&limit=30]

输出你所有启用的推送规则近 24 小时的命中并集（匹配语义与推送引擎一致，同一篇被多条规则命中只出一次）。参数只有 uid、k、type（缺省 RSS，type=json 可选）、limit（1–50，默认 30）；没有 id 参数，不能只取单条规则。

JSON 条目字段：id、is_zdm、title、url、catename、price、time（比关注流多一个 price，没有 louzhu）。

密钥入口：用户中心 → 信息推送设置 → 页面上的「订阅地址」按钮。与「我的关注」的订阅密钥是同一把——两处生成/重置的都是它。

说明：本端点目前没有单独的限流头，靠整包缓存（约 5 分钟）与正常使用约束；请勿高频轮询。

四、RSS 全站订阅（公共）

GET https://new.xianbao.fun/rss.php[?cate=别名][&tag=标签][&k=关键词][&limit=30]

参数	说明
cate	分类别名（如 weibo、haodan），自动包含子分类；也可填平台频道别名；缺省 = 全站
tag	按标签名过滤（填标签名本身，不是标签 ID）
k	按关键词过滤（只匹配标题）
limit	条数 10–50，默认 30

无需任何凭证，标准 RSS 2.0 输出，服务端缓存 5 分钟。不需要个人化筛选时用它最省事。三个参数可以叠加，但都只作用于全站内容、不读取你的筛选规则。

五、榜单 JSON（公共）

GET https://new.xianbao.fun/plus/json/rank_query.php?act=qitian&count=20

act 为 13 种榜单（与 /api/v1/rank 相同白名单，非法值返回 400）；count 20–300，默认 20，count≤50 时不返回 content；另可加 nofilter=1 跳过全部筛选。输出按当前登录态的筛选规则计算（未登录就是游客口径）。限流 60 次/分钟/IP，超限返回 HTTP 429 + JSON code:429 与 Retry-After 头。响应体是 {code,msg,list,stats,rules}，不是 /api/v1 的 data/meta 信封。一般对接建议优先用 /api/v1/rank（信封、字段字典、meta 能力清单更规范），本端点适合已按旧格式对接的存量脚本。

六、通用约定

• 限流：我的关注命中流 60 次/分钟/IP、榜单端点 60 次/分钟/IP，响应带 X-RateLimit-Limit / Remaining / Reset 头，超限 429 + Retry-After；推送命中流与 rss.php 目前没有限流头。
• 客户端缓存：我的关注、推送命中流与 rss.php 响应带 Cache-Control: public, max-age=300，RSS 阅读器按 5 分钟轮询即可，切勿低于 60 秒；榜单端点反而是 no-store，每次都是实时计算。
• 鉴权失败：JSON 返回 {"code":0,"msg":"forbidden"}（HTTP 仍为 200）；RSS 返回 403。先检查 uid/k 是否复制完整、密钥是否已被重置。
• 密钥与账号绑定：密钥跟随账号，不随密码修改变化；重置只影响订阅地址，不影响站内登录。

常见问题

Q：订阅地址打开是 403？
多半是 uid 或 k 少复制了字符，或密钥已在另一处重置。回设置页重新复制完整地址。

Q：改了关注规则，为什么订阅还没变？
整包缓存 5 分钟，等最多 5 分钟再刷新；不是没保存成功。

Q：RSS 里只有摘要，没有全文？
本页所有 RSS 的 description 都截断到 300 字；要全文请打开条目链接。开放 API 的 with_html=1 才能取正文 HTML。

更多背景见 开放 API 总览；字段口径与 /api/v1 共用的部分见 字段字典。