服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动，严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外，不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 1487 发布日期为2026年10月6日，适配列表缺失可能来自权限或请求条件，不能直接当作零适配。
- 美国、加拿大以外市场，列表只返回给刊登卖家或获授权代该卖家调用的用户；其他用户设置 true 会被忽略。
- IncludeItemCompatibilityList 默认 false，已有列表也不代表默认会返回明细；数量字段的条件要单独判断。
- 手动填写的适配列表与 eBay 目录产品的适配数据是两条路径，排查前先分清数据来源。
列表没回来，不等于这个零件没有适配车型
如果你的汽配同步程序突然少了 Item.ItemCompatibilityList，先把它看成“本次未取得列表”，不要直接写成“不适配任何车型”。字段没有返回，与列表真的为空，是不同的结果。
eBay 在2026年10月6日的 Trading API 1487 发布说明中，明确调整了 GetItem 对这个容器的访问权限。影响的是适配列表的读取条件，不能据此推断卖家刊登里的原有适配关系已经被删除。
最省时间的排查顺序是：确认刊登所属市场和调用用户，再看请求有没有要求返回列表，最后核对适配信息来自手动填写还是目录产品。先分清原因，才知道该改授权、参数还是读取路径。
美国、加拿大以外，谁能读到列表？
官方说明：除美国和加拿大市场外，Item.ItemCompatibilityList 只返回给该刊登的卖家，或获授权代该卖家发起 GetItem 调用的用户。其他用户即使把 IncludeItemCompatibilityList 设为 true，这个参数也会被忽略。
这里说的是 eBay 市场和调用身份，不是操作人员坐在哪个国家。人在美国、网络出口在加拿大，都不能替代对刊登市场和卖家授权的检查，也不能据此认定自己属于例外。
开发者应确认当前调用关联的是谁，以及这个用户是否能代表目标刊登的卖家。应用能够发出请求，与用户拥有所需卖家授权，是两个条件；不要为了排查让卖家把密码或访问令牌贴进公开讨论。
设了 true，为什么仍然没有明细？
IncludeItemCompatibilityList 的默认值是 false。想取明细，需要在请求中明确设为 true，但前提还包括刊登存在适配列表，以及调用满足当前访问条件。单独改这个开关，不能补上缺少的授权或原本不存在的数据。
GetItem 文档还说明：如果刊登存在列表，而这个参数为 false 或没有传，列表明细不会返回，但会返回 Item.ItemCompatibilityCount，表示兼容车型的数量。数量不是逐车型的名称、属性或适配备注。
这个数量规则不能扩大成“任何权限不足的请求都会拿到 count”。尤其是其他用户设置 true 后被忽略的情形，应按实际响应记录缺失项，不承诺数量一定存在，也不要编造固定 HTTP 状态或专属错误码。
手动列表和目录产品，别用同一条路读
官方对 ItemCompatibilityList 的说明有一个容易漏掉的边界：这里的列表针对卖家手动指定的适配详情，不是与 eBay 目录产品对应的适配数据。仅查这个容器，可能从一开始就选错了数据来源。
先查看刊登是否关联目录产品。对于目录产品对应的适配详情，GetItem 文档指向 Metadata API 的 getProductCompatibilities 方法；对于手动填写的列表，则继续核对 GetItem 的请求和权限条件。
两条路径不能无条件互换。目录兼容性不是任意刊登手动列表的复制品；选另一接口前，应以该方法当前文档确认支持范围和所需信息，不把方法名当作已经完成接入或保证能取得全部数据。
同步程序最该避免的是把缺失覆盖成空
处理结果时，分开保存“取得适配明细”“只有数量”和“未取得适配数据”这几种情况。遇到缺字段，先保留原记录与本次检查状态，查明原因后再决定如何更新，避免一次读取就清空已有适配关系。
一个虚构排查例子：某工具读取德国市场的汽配刊登，使用的用户不能代表该刊登卖家，虽然请求设置了 true，响应仍没有列表。这时应先查授权，而不是删掉原车型、不断重试或认定零件已经不兼容。
如果同一个工具读取的是目录产品适配数据，还要检查是否应采用文档指定的目录读取路径。这个例子用于解释排查顺序，并非实测结果；实际原因仍要结合具体刊登、调用身份与完整响应确认。
调整后，怎么确认解决的是同一个问题？
先在自己的授权环境里选少量、已知数据来源的刊登，记录市场、调用用户、参数值以及实际返回的容器。比较时保持这些条件一致，才能分清变化来自授权、请求设置还是刊登自身的数据差异。
需要明细时，确认程序能处理每条适配关系；只有数量时，确认界面没有把数量伪装成完整车型表；字段未返回时，确认下游没有自动生成“零适配”的结论。检查的是结果含义，而不只是请求是否收到响应。
1487 发布说明没有把旧版本号或更换网络列为恢复权限的方法。完成条件核对后仍无法解释结果，再带上不含密码、令牌及私人信息的请求条件向官方支持说明问题，避免把授权变化反复当成网络故障。
资料来源
常见问题
美国和加拿大市场是不是任何人都能取得全部适配数据？
不能这样推断。它们是这项新增访问限制的市场例外，但 GetItem 的请求参数、刊登是否有列表，以及手动数据与目录产品的区别仍需要核对。例外不等于所有汽配刊登都保证返回完整列表。
这种变化要求卖家重新填写所有汽配刊登吗？
已核对的1487说明调整的是列表读取权限，没有要求所有卖家重填适配关系。先确认原刊登的数据和调用条件；不要因为某次响应缺字段，就批量修改或清空刊登。
拿到 ItemCompatibilityCount，就能判断某一车型适配吗？
不能。数量只表示兼容车型的数量，不包含你关心的具体车型、属性组合或备注。要判断某一车型，需要取得并检查对应适配详情，同时确认零件与目标车辆的实际条件。