这一篇讲带密钥的个人订阅接口与两个扩展端点。它们和 /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 为值得买原文外链。数据约 5 分钟缓存；限流 60 次/分钟/IP。
三、推送命中流（个人）
GET https://new.xianbao.fun/zb_users/plugin/xbpush/api/feed.php?uid=你的ID&k=你的密钥[&type=json][&limit=30]
输出你推送规则近 24 小时的命中并集（匹配语义与推送引擎完全一致）。参数与上一节相同：type 缺省 RSS、type=json 可选；limit 1–50 默认 30。
密钥入口：用户中心 → 信息推送设置 → 规则页「订阅地址」按钮。与「我的关注」的订阅密钥是同一把——两处生成/重置的 都是它。
四、RSS 全站订阅（公共）
GET https://new.xianbao.fun/rss.php[?cate=别名][&tag=标签][&k=关键词][&limit=30]
| 参数 | 说明 |
|---|---|
cate | 分类别名（如 weibo、haodan），缺省 = 全站 |
tag | 按标签过滤 |
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 相同白名单）、count 20–300。限流 60 次/分钟/IP，超限返回 429 与 Retry-After 头。游客口径输出；一般对接建议优先用 /api/v1/rank（信封、字段字典、meta 能力清单更规范），本端点适合已按旧格式对接的存量脚本。
六、通用约定
- 限流：个人接口与榜单端点均为 60 次/分钟/IP；响应带
X-RateLimit-Limit / Remaining / Reset头，超限 429 +Retry-After，请按提示等待。 - 客户端缓存：个人接口响应带
Cache-Control: max-age=300，RSS 阅读器按此间隔轮询即可，切勿低于 60 秒。 - 鉴权失败：JSON 返回
{"code":0,"msg":"forbidden"}；RSS 返回 403。先检查 uid/k 是否复制完整、密钥是否已被重置。 - 密钥与账号绑定：密钥跟随账号，不随密码修改变化；重置只影响订阅地址，不影响站内登录。
更多背景见 开放 API 总览；字段口径与 /api/v1 共用的部分见 字段字典。