服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动，严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外，不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 10月6日的1487发布说明确认旧调用已退役，参考文档及仅供该调用使用的 WSDL 类型已移除。
- 9月21日是此前公布的计划日期；10月6日是本次正式发布说明日期，不能据此倒推每个请求路径的实际停止时刻。
- 受影响的是仍调用 GetAdFormatLeads 的线索同步，不是所有 Trading API、普通订单或全部 eBay 卖家。
- 替代方向是 REST Leads API。生产准入、卖家授权与当前方法规则要分别确认，旧调用不能充当长期回滚。
这次已经确认退役，为什么还要分清日期？
eBay Trading API 1487 的发布说明日期为2026年10月6日。正文明确确认 GetAdFormatLeads 已退役，并说明关联参考文档和专用 WSDL 类型已经移除。原先“截止已过，但官方终态尚未确认”的判断已不再适用。
此前计划停用日期为9月21日。这与10月6日的正式说明不是同一个时间口径；已读公告没有给出每个地区、应用或请求路径的准确停止时刻，也没有列出所有请求都会返回的固定错误。
实际行动可以确定：不要再把旧调用当作可持续使用的接口。文档页面是否还能打开、某次历史请求是否成功，都不能替代这份正式退役说明。
先找出真正受影响的线索作业
GetAdFormatLeads 用于取得 lead-generation listing 的销售线索，典型场景是 Classified Ad。先在自己的定时任务、集成配置和已有日志中定位这个调用，再查看哪些报表、CRM 或跟进流程依赖它。
没有使用该调用的普通订单同步，不应仅因 Trading API 出了新版本就一并重做。这次退役也不等于 eBay 关闭了全部 Trading API 或所有 Classified Ad 功能。
一个假设场景：定时作业每天把询盘交给销售。如果接口失败却仍显示“今日零线索”，团队可能把取数失败误当成没有询盘。应先把成功无结果与调用失败分开显示；这个例子不是本站实测。
换接口之前，先确认自己能用
eBay 的2025年第四季度开发者通讯把 REST Leads API 指定为旧调用的替代，并说明它围绕卖家的 active Classified Ad listings 提供线索读取。这给出了迁移方向，不等于每个应用已获生产访问资格。
本指南9月22日核对的 Leads 总览将其标为 Limited Release，即只向获批的部分开发者开放，并要求读取线索的卖家授权带有 sell.leads scope。scope 是授权允许的操作范围，不是更换一个网址就能自动补齐。
10月7日本次复核未能读到当前 Leads 总览完整正文，因此当前准入范围或授权要求是否另有变化仍未知。准备切换时应在官方总览、方法参考或 eBay 支持中确认，不能只凭旧 Trading keyset 或 Sandbox 结果认定生产权限已到位。
把旧作业的目的，对照到新方法
已核实的官方通讯列出两个方向：getClassifiedLeads 取得卖家 active Classified Ad listings 的线索，getClassifiedLeadsByItem 按指定刊登读取。先判断旧作业是跨刊登汇总，还是围绕一个 item 查询，避免选错方法。
接着对照当前方法文档核实时间范围、状态筛选、返回字段、分页和无结果行为。旧 XML 调用中的参数与新 REST 请求不能仅凭名称相似就机械搬过去；本文不把未复核的参数写成新的调用契约。
字段核对至少覆盖线索标识、对应刊登、时间及联系信息的缺失情况。缺失字段应保留明确状态，不能用空字符串覆盖已有资料，也不要把接口错误处理成删除历史线索。
切换失败时，保留数据而不是退回旧接口
使用团队已有的获批测试权限，在固定卖家、刊登和时间范围内核对新链路。确认读取范围和字段能支撑原任务后，再恢复下游写入或自动跟进；不要为了探测退役终态增加真实生产请求。
如果新接口尚未获批，或取数与对账不一致，先暂停受影响的自动写入与通知，保留历史记录和人工处理入口。旧 GetAdFormatLeads 已退役，不能作为长期回滚点。
完成迁移的判断应落在自己的链路：访问资格有依据、卖家授权正确、返回数据能解释、失败能识别。仅看到请求返回成功，仍不足以证明所有分页、字段和下游流程已经接好。
连接失败，先分清资格、授权和网络
遇到错误，先记录时间、请求标识、所用方法和响应内容，再检查应用批准状态、用户令牌、卖家归属与方法要求。官方未公布统一的退役错误契约，不能仅凭一个状态码就判断所有原因。
DNS、TLS、连接超时和代理鉴权错误属于另一层问题，可按站内代理连接排查文章定位。固定出口不会恢复已退役的调用，也不能取得新 API 的准入或补发卖家授权。
把每次排查限定在一个变量，会更容易找到原因。不要同时更换应用、账号、刊登、授权和网络，然后把一次偶然成功当成迁移完成。
资料来源
常见问题
已经取得的销售线索要不要删除？
接口退役不是删除历史资料的通知。按团队原有的数据用途、权限和保留规则处理，迁移时避免把缺失字段或请求失败覆盖成空记录。
还能通过旧参考页生成客户端吗？
1487 说明已移除旧参考文档和仅供该调用使用的 WSDL 类型。保存过的文档或生成代码可以帮助理解历史集成，但不能证明旧调用现在可用。
普通订单同步也要改用 Leads API 吗？
Leads API 面向 Classified Ad 销售线索，不是订单接口的通用替代。先确认自己的任务是否真正调用 GetAdFormatLeads，再决定对应迁移范围。