新更新
作为 eBay 持续简化和现代化开发者平台的一部分，多个已弃用的Product Metadata接口即将停止服务。这些接口目前已被弃用并计划于2026年7月15日正式下线。接口下线后将无法正常调用，请及时迁移至新接口以避免业务受到影响。
受影响的 API 接口
以下接口属于本次下线范围：
Product Metadata API中的
· 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 – getCompatibilitiesBySpecificationREST接口: 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 与我们联系。
过往更新
- 2026-06-02旧版Product及Product Metadata兼容性相关接口将于2026年7月15日下线的通知
- 2026-05-08重要: eBay Marketing API中的最低值变更通知
- 2026-04-23Compliance API停用公告
- 2026-04-14GetCategoryFeatures API停用公告
- 2026-03-11Marketing API中Quick Setup功能即将停用
