开发者专区

影响API对接的重要更新

发布时间：2025-09-09          最近刷新时间：2025-09-10

尊敬的开发者，

感谢您作为eBay社区的一份子。我们联系到您是为了通知您关于接下来API的变化。这些变化主要关于美国人的用户和财务数据，影响到API对特定个人和企业的返回和处理。

为什么您会被影响:

我们正在修改特定数据该如何处理以及该如何通过API传输给到特定个人和实体。作为使用eBay API的第三方开发者，这些变化对你的应用会有影响，而且可能会影响到你的数据处理流程。

会有什么变化？

1. 美国人的用户名替换:

• 在所有涉及美国人用户数据的API返回中，用户名的值会被不可变的公共用户ID所取代。API的request URL, request parameters, 和request body现在都支持不可变的用户ID。
• 被影响的APIs: 所有处理美国人用户名数据的APIs，包括Sell Feeds APIs和notification API。
• 注意: 非美国人的用户数据不会受影响，仍会原样返回。

2. 美国人财务数据的处理：

• 对美国人来说，作为买家的支付工具和银行细节类的财务数据现在将会被保护。你将会看到相关API返回中有“protected”的字样。
• 被影响的APIs：

1. Transaction APIs: GetOrders, GetItemTransactions, GetSellerTransactions, Fulfillment APIs 包括 Sell Feeds API 的 Order reports.

2. Notifications: FIXED_PRICE_TRANSACTION, AUCTION_CHECKOUT_COMPLETE, END_OF_AUCTION, CHECKOUT_BUYER_REQUESTS_TOTAL, ITEM_MARKED_SHIPPED.

• 被影响的字段：买家的PaymentMethod和PaymentInstrument
• 注意: 非美国人的财务数据不会受影响，仍会原样返回。

时间线

这些变化将会在2025年9月24日生效，涵盖您应用对接的全部API。

建议第三方采取的行动

1. 更新您的应用：修改您的应用来适应API的数据新变化，并确保能够有效的处理变化的用户名和被保护的买家的金融数据。

2. 通知您的卖家：和您的卖家沟通这些变化，尤其是如果之前您的应用有用到这些被影响的数据和API的情况下，请和卖家着重强调您的应用处理数据时的变化。

在eBay我们致力于为您将这些API更新做到尽可能流畅。在这段时间您有任何问题或者协助都可以联系我们团队。

如果您需要进一步的帮助，请联系Developer Technical Support或发邮件到DL-eBay-CBT-API@ebay.com。

此致，

eBay Greater China API Team