开发者专区

旧版Product及Product Metadata兼容性相关接口将于2026年7月15日下线的通知

发布时间：2026-06-02          最近刷新时间：2026-06-02

作为 eBay 持续简化和现代化开发者平台的一部分，多个已弃用的Product Metadata接口即将停止服务。这些接口目前已被弃用并计划于2026年7月15日正式下线。接口下线后将无法正常调用，请及时迁移至新接口以避免业务受到影响。

受影响的 API 接口

以下接口属于本次下线范围：

Product Metadata API中的

· getCompatibilitySearchNames

· getCompatibilitySearchValues

· getCompatibilitySearchValuesBulk

· getCompatibilitySearchDataVersion

· findCompatibilitiesBySpecification

变更原因

这些旧版接口最初是用于支持Trading API和Product API中的汽配（Parts & Accessories）的兼容性查询以及基于产品目录（Catalog）的刊登功能。目前，Sell Metadata API（包括其兼容性相关接口）以及Commerce Catalog API提供了相同功能且增强过的替代方案。这些新接口的优势：更好的一致性、更丰富的元数据、包括兼容性数量及更现代化的集成模式。

REST API的替代方案

所有受影响的SOAP/XML接口均已更新至 REST API。我们建议您尽快迁移至以下替代接口：

· findCompatibilitiesBySpecification → Sell Metadata – getCompatibilitiesBySpecification
  REST接口: POST /sell/metadata/v1/compatibilities/get_compatibilities_by_specification
· getCompatibilitySearchNames → Sell Metadata – getCompatibilityPropertyNames
  REST接口: POST /sell/metadata/v1/compatibilities/get_compatibility_property_names
· getCompatibilitySearchValues → Sell Metadata – getCompatibilityPropertyValues
  REST接口: POST /sell/metadata/v1/compatibilities/get_compatibility_property_values
· getCompatibilitySearchValuesBulk → Sell Metadata – getMultiCompatibilityPropertyValues
  REST接口: POST /sell/metadata/v1/compatibilities/get_multi_compatibility_property_values
· getCompatibilitySearchDataVersion → Sell Metadata – 版本相关字段
  说明：该接口不存在完全对应的1:1替代方法。建议改为使用Sell Metadata API兼容性接口响应中返回的：metadataVersion 以及其他相关版本字段来实现缓存管理和版本控制。

更多信息

有关完整的请求/响应结构、身份验证要求以及调用示例，请参阅developer.ebay.com上的Sell Metadata API文档。

如您有任何疑问或需要进一步协助，欢迎通过邮箱 DL-eBay-CBT-API@ebay.com 与我们联系。