向百度推送接口提交链接后，返回的 remain 和 not_valid 字段怎么读
调用百度搜索资源平台的 API 推送链接后，返回结果里的 remain、not_valid 等字段分别说明什么？这两个字段一个是余量信号、一个是质量信号：remain 告诉你当日配额还剩多少，not_valid 告诉你提交里哪些链接没通过校验。每次调用后按「成功条数、剩余额度、无效清单」的顺序读返回，对得上数就收工，对不上再查站点归属与链接格式。AnQiCMS 的链接推送模块对接了百度推送的主动推送通道，返回字段遵循同一套规则。
成功返回的四个字段各管什么
| 字段 | 含义 | 后续动作 |
|---|---|---|
| success | 本次被受理的链接条数 | 与提交数比对，差额进入排查 |
| remain | 当日剩余配额 | 为零时把余量排到次日，或核对提额入口 |
| not_same_site | 提交的地址不属于已验证站点 | 检查域名归属与协议写法是否一致 |
| not_valid | 地址不合法 | 逐条检查格式、参数与页面状态 |
官方文档把 API 推送列为最快速的提交方式，建议站点当天新产出的链接立即推送，让新链接及时被百度发现。
失败返回先区分哪两类
失败响应分两类：以 4 开头的客户端错误码，和 500 服务端错误码。前者基本是调用自身的问题——令牌过期、站点未验证、请求格式不对，重试一百次也不会变绿；后者是平台侧的临时状况，按退避节奏重发即可。两类混在一起处理，是推送脚本越修越乱的主要原因。
配额被扣光的常见原因
一是重试脚本不做幂等，同一批链接反复提交把额度吃光；二是把测试数据、附件资源链接也放进了提交清单；三是站点归属验证失败后整批换着域名重提。稳妥做法是当天新产出的、此前没推送过的链接才走主动推送，调用后把四个字段写进日志，次日对账就能看清配额消耗是否来自正常发布。
推送和站点地图各覆盖哪一段
主动推送解决「今天有新增或变更，立刻告知」；站点地图（Sitemap）解决「全量家底交底，便于周期性重扫」。AnQiCMS 支持 Sitemap 自动生成，同时具备百度与 Bing 的推送通道，两条链路各管一段：新内容走推送抢时效，存量修正靠站点地图兜底。发现一批页面长期没被抓取，先看站点地图里有没有它们，再看推送返回里是否躺着 not_valid。
常见问题
问：remain 数值很小，是站点出问题了吗？ 答：不一定。配额由平台按站点情况分配，额度小只改变「当天内容推完」的节奏，可以把超出部分分批提交，关键是观察 success 与提交数是否一致。
问：链接一直进 not_valid，先查什么？ 答：先查写法——协议、域名是否与已验证站点严格一致，再查页面本身是否可正常访问。若地址靠 301 指向另一处，提交重定向完成后的最终地址。
问：推送了多久会收录？ 答：推送只缩短「被发现」的环节，收录与排序还取决于内容质量与页面体验，不要把推送成功直接当成收录完成。