一、开发者认证迁移
- 由于原有开放平台开发者没有进行过认证,所以进行应用迁移之前,开发者需要打开有赞云控制台(https://diy.youzanyun.com)进行企业认证和邮箱验证(请填写常用邮箱,以便及时获取应用状态和最新产品变更事宜)
- 提交认证审核后,运营人员将在一个工作日内完成认证审批
二、应用迁移
应用信息和配置迁移 与 应用授权关系迁移 分两部分进行迁移,开启时间:4月初
2.1 应用信息和配置迁移
- 应用开发者注册认证之后,开发者登录diy平台,diy后台判断这个用户是否在老开放平台创建过工具型应用,有的话将显示「一键迁移」按钮,点击后将实现应用信息和配置迁移至diy后台
- 迁移模块主要包含:应用信息迁移、API权限信息迁移、消息推送配置和订阅信息迁移
2.2 应用授权关系迁移
- 应用迁移后将给予开发者两周时间进行应用改造和上架应用市场
- 开发者进行接口配置调整和应用展示信息调整之后,可发起应用上架申请,审核通过后,将在新版应用市场展示(审核时间3个工作日)
- 开发者完成应用市场上架,在上架时,后台触发动作停止老开放平台的应用授权功能,同时原有应用商家授权关系自动迁移到新平台,所有迁移配置到上架的操作尽量在两周内完成
- 19年5月30日原开放平台将停止维护,工具型应用将关闭新增授权功能
PS 迁移注意事项
- 订购体系上线:新版应用市场将上线应用订购体系
- 授权逻辑变化:工具型应用只有上线应用市场,商家进行订购后,才可授权绑定,进行接口调用/获取推送信息,不再提供授权链接授权模式
- 老接口下线:老版kdt开头的接口和交易3.0的两个接口(youzan.trades.sold.get 3.0.0 和 youzan.trade.get 3.0.0),将不包含在迁移模块中,需要开发者升级至新版接口
三、文档指引
迁移接口注意事项 接口名 | 接口变动信息 | youzan.ump.coupons.unfinished.search.3.0.0 | 响应参数start_at,end_at,created,updated均为时间戳(原来为日期格式) | youzan.ump.presents.ongoing.all.3.0.0 | 响应参数start_at,end_at,created,modified均为时间戳(原来为日期格式) | youzan.ump.promotion.get.3.0.0 | 入参和返回参数都变了,需要重新对接接口 | youzan.trade.bill.goods.url.get.3.0.0 | 需要升级为youzan.trade.bill.goods.url.get.3.0.1 | youzan.trade.bill.good.url.get.3.0.0 | 需要升级为youzan.trade.bill.good.url.get.3.0.1 |
四、接口调用
3.1 升级SDK调用
3.1.1 API请求 1)新SDK的返回参数和请求参数对象的类名一样
2)返回参数和请求参数对象的包名不一样,老SDK是com.youzan.open.sdk开头,新SDK是com.youzan.cloud.open.sdk
3)新SDK的请求方法和老SDK有所差别,即invoke方法有差别,但是差异不大
3. 新的其他语言SDK,其他语言SDK由于没有进行模型映射,只是一个请求的client,所以老sdk升级版本就是新sdk
3.1.2 TOKEN获取 - DefaultYZClient yzClient = new DefaultYZClient();
- TokenParameter tokenParameter = TokenParameter.code()
- .clientId("client-tool")
- .clientSecret("client-tool")
- //授权码
- .code("code")
- .redirectUri("redirectUri")
- .build();
- OAuthToken codeToken = youZanClient.getOAuthToken(tokenParameter);
复制代码
3.2 HTTP调用
3.2.1 API请求 如果开发者自己封装的http调用,没有通过SDK,那么开发者需要切换请求前缀:
举个例子,以获取客户列表为例,原来get请求是 :
- https://open.youzan.com/api/oauthentry/youzan.item/3.0.0/get?access_token=418ab734cee63608959b7cc134fd4a14&item_id=405464579
复制代码 修改后的get请求如下:
- https://open.youzanyun.com/api/youzan.item.get/3.0.0?access_token=418ab734cee63608959b7cc134fd4a14&item_id=405464579
复制代码
3.2.2 TOKEN获取 举个例子,之前用户获取 - curl -X POST https://open.youzan.com/oauth/token -H 'content-type: application/x-www-form-urlencoded' -d 'client_id=testclient&client_secret=testclientsecret&grant_type=silent&kdt_id=88888'
复制代码用户使用新的方式调用 - curl -X POST https://open.youzanyun.com/auth/token
- -H 'content-type: application/json' 'authorize_type:authorization_code'
- -d '{"client_id":"client-tool","client_secret":"client-tool","code":"code","redirect_uri":"redirectUri"}'
复制代码
本帖最后由 -Sophia Zz. 于 2019-4-15 19:46 编辑
|