ENGINEERING NOTE 46 / 50 · CARD

支付API保持鉴权,公开文档仍可被收录

OPEN RAMBO ·

受保护API向匿名爬虫返回401,不自动代表故障。公开文档与私有接口响应需要不同访问和收录策略。

本文由 OPEN RAMBO 发布。工程方案和伪代码用于说明设计,不是现有产品 API 文档;示例数字均为演示。

先确认受影响网址

搜索控制台告警要看具体URL。若为需凭据接口,不能为消警而移除鉴权。检查公开文档是否误把爬虫引向私有接口。

分离示例与接口

公开路由提供解释HTML、请求示例和安全占位符。账户、产品和交易接口保留既有访问检查。文档示例不能含真实凭据或客户数据。

检查发现路径

站点地图列规范公开页,不列需认证API。验证公开页有真实HTML,私有接口仍受保护。HTTP成功不保证收录,单接口排除也不等于全站故障。

示意流程

public_docs = "/docs/payment-workflows/"
private_api = "/api/account/transactions"
# Public HTML: indexable. Private API: authorization required.

如何验收

匿名测试两类路由,公开文档可读,API受保护,站点地图无带秘密网址。

延伸阅读

继续阅读