一直以来，eBay致力于为卖家提供稳定高效的平台化运营服务。为了提升服务质量， SpeedPAK物流服务的下单平台eDIS即将迁移至新技术环境。

届时，卖家的历史数据，包含用户信息、财务、订单、包裹等数据将会被迁移至新平台。正在使用API访问eDIS的开发者须在3月31日之前完成新平台的技术对接切换工作，以保障下单正常

开发者可以联系dl-ebay-edis-api@ebay.com 获得技术支持。

其他使用eDIS的卖家，eBay将会以站内信的形式通知具体迁移时间，无需操作即可正常使用服务。新用户在在2月28日之前可以在原平台注册并使用，此后须通过新平台注册使用服务

以下是针对开发者接口切换的指南：

迁移目标

为优化用户体验，eBay即将迁移eDIS平台至新环境。为尽可能保证eDIS终端用户实现顺畅无感的迁移，建议各位开发者提前准备相应的调整。迁移过程中将会涉及以下调整：

•eDIS新平台将提供新的临时登录域名：edis.ebay.com

•eDIS新平台API访问将提供新的临时访问域名：edisapi.ebay.com

•eDIS新平台API将根据eBay RESTful APIs框架进行调整

•eDIS新平台接口名与字段名将根据eBay Public API命名规则进行调整

•eDIS用户数据将分批迁移至新环境

开发者文档请至open.edisebay.com/open/new-api-document-detail获取详情。

第三方开发者请提前联系dl-ebay-edis-api@ebay.com获取技术支持。

如果有任何问题，请随时联系我们 。

计划时间表

2025

注意，开发者需要申请迁移至eDIS新平台。

申请方式

迁移指南

1.接口Header中Authorization值获取方式修修改

•参考eBay RESTful API方式：

https://developer.ebay.com/api-docs/static/oauth-auth-code-grant-request.html#

•API scope设置增加 https://api.ebay.com/oauth/scope/sell.edelivery

2.接口结构调整

•新增cancelPackage（单个取消单号）

  •新增deletePackage（单个删除包裹）

  •删除FetchToken（登录认证）

  •删除AddPackageWithoutService（无指定物流服务上传包裹）

  •删除AssignService（指定包裹物流服务）

  •合并GetPackageStatus, GetPackageDetail 为getPackage

  •合并GetLabel, GetLabels, GetLabelList为getLabels

  •仅读取功能的接口调用方法调整为GET，请求参数加入到parameters

  •删除接口中的isId, ebayId, timestamp, messageId等字段

  •接口名、字段名根据eBay Public API命名规则相应调整

  •部分接口报文结构调整

3.请求参数的实体Dto路径替换

•  在新SDK中，Dto和ENUM的Java实体类路径发生了变动。客户端可以通过以下方式在IDE（如IntelliJ IDEA或Eclipse）中进行全局替换，以适配新的SDK版本。建议使用全局查找与替换功能，快速修改代码中的路径引用。

4.如何引用sdk jar包

• 将sdk jar包打包到本地的maven仓库中，可以使用以下maven指令将jar打入maven仓库中。 

mvn         deploy:deploy-file          -DgroupId=com.test          -DartifactId=edis-sdk          -Dversion=1.0.SNAPSHOT          -Dpackaging=jar          -Dfile=D:\test\sdk\edis-sdk.jar          -Durl=http://10.10.10.127:8081/nexus/content/repositories/snapshots          -DrepositoryId=snapshot

• 将maven dependency 加入到pom文件中

< dependency >

    < groupId> com.test < /groupId >

    < artifactId > edis-sdk < /artifactId >

    < version > 1.0.SNAPSHOT < /version >

< /dependency >

5.SDK客户端调用接口方法替换（Java）

•  旧SDK调用方式：

AddPackageRequest req = new AddPackageRequest(); 

EbayClient client = new DefaultEbayClient(base_url, authorization); 

AddPackageResponses rsp = client.execute(req); 

•  新SDK调用方式：

新SDK中，每个接口都有独立的方法，客户端需要针对每个接口调用不同的方法。调用方法示例如下： 

ApiClient client = Configuration.getDefaultApiClient(); 

OAuth sell_scope_auth = (OAuth)client.getAuthentication("sell_scope_auth"); 

sell_scope_auth.setAccessToken(authorization); 

CommonBusinessApi apiInstance = new CommonBusinessApi(); 

AddPackageResponses addPackageResponses = apiInstance.createPackage(req);