有赞新零售社区

发帖
有赞云历史板块»开放平台工具型应用迁移有赞云教程

开放平台工具型应用迁移有赞云教程

叶墨迹 2019-01-24 11214 浏览 5 评论 | 只看楼主 [打印]
工具型应用迁移背景,详见:工具型应用迁移及应用市场合作说明


有赞云DIY后台「一键迁移」功能已上线,现可以登陆控制台进行迁移操作(网址:https://diy.youzanyun.com/application/list),点击按钮进行迁移后,需确认应用信息、推送配置,无误后即可根据文档接入新sdk和进行接口测试,迁移详细流程见文档:https://diy.youzanyun.com/doc/3517, 请尽快开启迁移,4月底前完成迁移,旧控制台将于下周关闭新增应用功能,5月后将停止使用

一、开发者认证迁移

  • 由于原有开放平台开发者没有进行过认证,所以进行应用迁移之前,开发者需要打开有赞云控制台(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请求
  • 新JAVA SDK:
        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获取
  1. DefaultYZClient yzClient = new DefaultYZClient();
  2.   TokenParameter tokenParameter = TokenParameter.code()
  3.       .clientId("client-tool")
  4.       .clientSecret("client-tool")
  5.       //授权码
  6.       .code("code")
  7.       .redirectUri("redirectUri")
  8.       .build();
  9. OAuthToken codeToken = youZanClient.getOAuthToken(tokenParameter);
复制代码

3.2 HTTP调用

3.2.1 API请求
如果开发者自己封装的http调用,没有通过SDK,那么开发者需要切换请求前缀:

举个例子,以获取客户列表为例,原来get请求是 :
  1. https://open.youzan.com/api/oauthentry/youzan.item/3.0.0/get?access_token=418ab734cee63608959b7cc134fd4a14&item_id=405464579
复制代码
修改后的get请求如下:
  1. https://open.youzanyun.com/api/youzan.item.get/3.0.0?access_token=418ab734cee63608959b7cc134fd4a14&item_id=405464579
复制代码

3.2.2 TOKEN获取
举个例子,之前用户获取
  1. 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'
复制代码
用户使用新的方式调用
  1. curl -X POST https://open.youzanyun.com/auth/token
  2. -H 'content-type: application/json' 'authorize_type:authorization_code'
  3. -d '{"client_id":"client-tool","client_secret":"client-tool","code":"code","redirect_uri":"redirectUri"}'
复制代码
本帖最后由 -Sophia Zz. 于 2019-4-15 19:46 编辑
用手机打开
收藏 ··· 回复
    月夜小几扑   黄金   2019-02-15 | 只看该作者
    支持 祝有赞越来越好{:2_31:}

      枫叶1111   青铜   2019-03-20 | 只看该作者
      新SDK在哪里下载,https://open.youzan.com/open-sdk ... a&version=2.0.2 这个下载还是老的,没有变化啊。

        -Sophia Zz.   白银   2019-03-27 | 只看该作者
        枫叶1111 发表于 2019-3-20 11:15
        新SDK在哪里下载,https://open.youzan.com/open-sdk/download?type=java&version=2.0.2 这个下载还是老的 ...


        新skd,在4月初迁移正式开放后会提供

          shangzhou   青铜   2019-04-11 | 只看该作者
          请问「一键迁移」功能,具体什么时间开启?上次看公告显示“已在原开放平台控制台进行应用创建的开发者,可等待4月10号开启上线的「一键迁移」功能,原应用的应用信息和授权关系,可以进行自动迁移
          但是今天登录有赞云,没发现「一键迁移」功能

            radeon3   青铜   2019-04-16 | 只看该作者
            php
            https://open.youzanyun.com/api/youzan.user.basic.get/3.0.0?access_token=37c6816f687ca25b785a01bdb05ab36d
            发送POST

            {"user_id":"42850630"}


            接口返回
            {"gw_err_resp":{"err_code":4005,"err_msg":"非法的API"}}

            是啥原因呢





              1跳至
              您需要登录后才可以回帖 登录 | 立即注册

              本版积分规则

              复制链接
              新浪微博
              QQ空间
              微信扫码
              • 回复

              • 评分

              客服工作时间是9:00-18:00,客服妹子当前不在线,若不能及时回复请谅解。试试右上角的搜索吧,论坛有丰富的经验贴、公告贴,相信一定能够帮到您~

              复制成功