8.0
热点
AI SCORE
技术实践2026-11-18 02:30
接口示例换了,九个探针仍在用旧值
dev.to · AI#接口文档#网关日志#接口迁移
Editor brief · 编辑速览
一天的网关日志显示,接口更换请求示例后,9 个第三方探针仍原样提交旧占位值,共发出 26 次请求。日志还记录了对已下线服务和错误路径的调用,暴露了机器客户端获取迁移信息时的困难。
文章思维导图
Knowledge map
AI brief
原文暂未完整获取,基于公开信息的快读
11 月 17 日,作者团队把一个付费接口的请求示例从占位值换成了能通过参数校验的真实值。但在一天的网关日志里,排除自家探针后,仍有 9 个第三方服务原样提交旧占位值,共发出 26 次请求。其中两次发生在示例更新一小时以后。
目前能确认什么
旧示例列出了 7 个参数名,每个参数都填了占位值。人读到这里会自行替换,自动客户端却可能把 HTTP 402 响应里 extensions.bazaar.info.input 的内容直接带进请求。按作者的解释,第三方索引服务在收录时就保存了示例副本,服务端更新后,旧副本仍可能被调用方使用。
同一天的日志还记录了下线服务和错误路径的请求。两个下线服务都返回 404,但响应体给出的信息不同。language-detect 有 delisted: true,并在 hint 里指出替代服务 x402-ai-language。ai-name-gen 只提示去查目录,当天仍收到 17 次外部请求。作者说这项修复已排期,在文章记录的时间点尚未上线。
我的判断
如果接口示例会被机器直接执行,就该把它纳入发布测试。从实际的 402 响应里提取示例,送进处理器的参数校验。这样能在发布前发现占位值,也能发现参数规则改了、示例却忘了更新的问题。
迁移提示也可以再往前走一步。节选把替代服务 ID 写在 hint 文本里,客户端可以靠 delisted 判断接口已下线,但要自动切换,还得知道替代 ID 从哪个字段取、请求参数是否兼容。节选也没交代第三方索引多久刷新一次,因此无法凭这一天的日志判断旧示例还会被重放多久。