服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动，严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外，不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 官方给出的 decommission 日期是 2026 年 9 月 21 日，但没有具体时刻或时区；日期已过不等于公开页面已经确认执行完成。
- 截至 9 月 22 日，API Deprecation Status 仍把 GetAdFormatLeads 放在 scheduled 表，并使用 will be decommissioned；它没有出现在同页的 already decommissioned 表。
- GetAdFormatLeads 参考页也仍保留未来时态和旧调用文档；这不能证明调用继续可用，真实生产结果与错误契约仍是 UNKNOWN。
- 替代项是 Limited Release 的 REST Leads API，提供 GET /classified_lead 和 GET /classified_lead/{itemId}，生产准入与 sell.leads OAuth scope 都要单独确认。
- 不要为验证终态而扩大生产调用。已有合规测试账号可保存请求 ID、HTTP 状态和时间；没有测试权限时按截止已过处理风险并完成新链路迁移。
- 旧接口不能作为可靠长期回滚点；新 API 未获批或对账失败时，应暂停自动写入、保留人工对账和向 eBay 支持确认，而不是把页面措辞当成运行证明。
先给结论：截止已过，官方终态仍未闭环
eBay API Deprecation Status 给 GetAdFormatLeads 标出的 decommission 日期是 2026 年 9 月 21 日。到了 9 月 22 日，该条目仍位于“deprecated and scheduled for decommission”表，说明文字仍是“will be decommissioned”；同一页面下方另有“have already been decommissioned”表，但其中没有 GetAdFormatLeads。
这组页面证据只能确认截止日期已经过去、迁移方向没有变化，不能确认 eBay 是否已在所有 marketplace、应用或请求路径上执行关停，也不能证明旧调用仍可用。GetAdFormatLeads 参考页仍可打开且仍展示请求和响应结构，同样只是文档可读性，不是生产端点健康证明。
影响谁：仍从 Classified Ad 拉取销售线索的系统
受影响的是使用 Trading API GetAdFormatLeads 拉取 lead-generation listing 线索的团队，例如 Classified Ad、汽车或房地产等场景；普通拍卖、一口价订单和不使用该调用的任务不应被泛化为受影响。先在代码、调度、监控和凭据清单中定位真实调用者，再决定迁移优先级。
截止已过后，最危险的误读有两个：一是看到官方文档仍在线就认为旧 API 获得宽限；二是把日历日期直接写成所有账户都已返回固定错误。官方没有公开具体时刻、时区、分批范围或请求级错误契约，这些字段必须保持 UNKNOWN。
先过准入门槛：Limited Release 与 OAuth scope
Leads API 官方总览将替代接口标为 Limited Release，只向获得业务部门批准的部分开发者开放；需要生产访问时应联系 eBay support。现有 Trading API keyset、卖家授权或 Sandbox 可调用，不等于生产 Leads API 已获批。
新接口使用 REST OAuth，读取线索需要 https://api.ebay.com/oauth/api_scope/sell.leads。迁移清单应分别记录应用 keyset、环境、卖家账号、授权 scope、marketplace 与批准状态；先在授权层确认 scope，避免把 403 误判为 IP、JSON 或 endpoint 故障。
两个新端点：全店检索与单 Item 读取分开
GET /classified_lead 用于在卖家的 active Classified Ad listings 中按日期范围和状态检索线索；GET /classified_lead/{itemId} 只查看指定 Classified Ad listing。旧作业若不传 ItemID、靠时间与状态拉全量，应先对照前者；按单个 ItemID 轮询的作业则对应后者。
不要只把 XML 方法名换成 REST URL。旧调用的 StartCreationTime、EndCreationTime、Status、ItemID 与 DetailLevel 行为，需要逐项映射到新方法实际支持的查询参数和响应字段；marketplace、时间边界、分页及无结果行为都以当前方法参考为准。
字段与双读：验证语义，不扩大副作用
旧调用以 XML 返回 AdFormatLeadCount 和 AdFormatLead 节点；新 Leads API 返回 REST/JSON 资源，并在 ContactInformation 中组织联系人字段。建立字段表时至少标出业务用途、旧路径、新路径、是否可空、个人数据级别和下游消费者，不要用空字符串覆盖已有客户记录。
若团队已有获批的合规测试账号和既定测试授权，可固定 marketplace、itemId、时间范围与状态，对比新链路的数量、标识、时间、联系信息存在性和分页完整性。旧调用只记录现有作业自然产生的请求 ID、HTTP 状态和时间，不为探测终态额外扩大生产流量，也不触发 CRM 写入、通知或自动跟进。
失败分层：准入、授权、Listing 与网络分别判断
401/403 先核对用户令牌、sell.leads scope、应用批准状态和卖家归属；404 或空结果先核对 item 是否属于当前卖家、是否为 active Classified Ad 及 marketplace；429 按官方限额与 Retry-After 处理；5xx 保存 request ID 并停止扩流。不要同时更换账号、scope、item、marketplace 和出口。
只有 DNS、TLS、代理 407、连接超时，或同一 endpoint 在不同合规出口稳定分叉时，才参考<a href="/resources/proxy-connection-troubleshooting-checklist">代理连接系统排查清单</a>。固定 IP 不能取得 Limited Release 资格、补发 OAuth scope，也不能证明 GetAdFormatLeads 的平台终态。
切换与停止条件：不要把旧调用写进长期回滚
截止日期已过且官方尚未公开请求级终态时，应按旧接口随时不可用设计。完成标准是：生产准入有证据；所需卖家重新授权 sell.leads；全店与单 item 的实际使用路径通过；字段、个人数据、分页、空结果、限流和超时已测试；监控能区分零线索与调用失败。
如果新 API 尚未获批或对账失败，停止自动写入和自动跟进，保留人工对账并向 eBay 支持确认；不要继续依赖旧调用，也不要声称所有账户已经按某个固定错误终止。复查条件是 eBay 将该调用移入 already decommissioned 表、发布延期/错误契约，或账户级可复核结果改变当前边界。
资料来源
常见问题
GetAdFormatLeads 已经确认停用了吗？
eBay 给出的日期是 2026 年 9 月 21 日，但截至 9 月 22 日，官方状态页仍把它放在 scheduled 表并使用未来时态，尚未在公开页面确认 already decommissioned。日期已过，应按高风险旧接口处理，但不能编造所有账户的运行结果。
参考页还能打开，是否代表旧调用仍可用？
不是。文档可读只证明说明页仍在线，不证明生产端点、所有 marketplace 或所有应用仍能成功调用。
REST Leads API 对所有开发者开放吗？
不是。官方将它标为 Limited Release，生产访问只向获批准的部分开发者开放，需要向 eBay support 确认。
新 API 需要什么 OAuth scope？
读取销售线索需要 https://api.ebay.com/oauth/api_scope/sell.leads，并使用对应卖家的用户授权令牌。
怎样核对真实终态而不扩大风险？
优先保存现有合规作业自然产生的请求 ID、HTTP 状态和时间；只有既有授权与测试账号时才做受控只读验证，不扩大生产流量、不触发 CRM 写入或通知。
旧调用还能当回滚方案吗？
不能作为可靠长期回滚。新链路失败时应停止自动写入、人工对账并修复 REST 集成，而不是把未确认可用的旧调用当灾备。