eDIS平台迁移开发者操作说明书
迁移目标
为优化用户体验，eBay即将迁移eDIS平台至新环境。为尽可能保证eDIS终端用户实现顺畅无感的迁移，建议各位开发者提前准备相应的调整。迁移过程中将会涉及以下调整：
- eDIS新平台将提供新的登录域名：edis.ebay.com
- eDIS新平台API访问将提供新的访问域名：https://api.ebay.com/sell/edelivery_international_shipping/v1
- eDIS新平台API将根据eBay RESTful APIs框架进行调整
- eDIS新平台接口名与字段名将根据eBay Public API命名规则进行调整
- eDIS用户数据将分批迁移至新环境
开发者文档请至open.edisebay.com/open/new-api-document-detail获取详情。
第三方开发者请提前联系dl-ebay-edis-api@ebay.com获取技术值支持。
如果有任何问题，请随时联系我们 。
计划时间表
| 2024-12-18 | 新平台部署完成 |
|---|---|
| 2024-12-18 ~ 2025-01-10 | 邀请部分第三方开发者测试 |
| 2025-01-13 | 所有开发者开放测试，开放迁移申请 |
| 2025-02-24~ 2025-02-28 | 第三方开发者迁移用户数据 |
| 2025-03-03~ 2025-03-30 | 其他开发者迁移阶段，每周开放一次迁移维护时间，开发者可以根据需要选择部分用户数据迁移 |
| 2025-03-31 | 迁移剩余用户数据至新平台 |
注意，开发者需要申请迁移至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版本。建议使用全局查找与替换功能，快速修改代码中的路径引用。
| 旧平台路径 | 新平台路径 |
|---|---|
| com.ebay.eis.dto.request | com.ebay.app.model |
| com.ebay.eis.dto.responses | com.ebay.app.model |
| com.ebay.eis.dto.enumeration | com.ebay.app.model |
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);