文档中心
创建开放应用及卖家授权
更新时间: 2018-01-25 18:37:50 访问次数:13464

基于Oauth2.0认证机制,您使用万邑通(Winit)开放平台(developer.winit.com.cn)物流接口需注册开发者账户,登陆开发者控制台可创建 “应用”来管理您系统上绑定的万邑通账户和获得的授权。
通过本操作您可以获取接口调用时需要的:

  • client_id
  • client_secret(需要使用该值计算出API的client_sign参数值)
  • appkey(万邑联账户/卖家账户登录邮箱,username也叫account)
  • token(授权码,需要使用该值计算出API的sign参数值)
  • platform

说明:

  • 1.通俗的理解”应用”是指您的ERP系统(可依版本或不同系统来创建不同的应用),创建应用会对应生成client_id和client_secret,并获得一个授权链接。
  • 2.使用您的ERP系统(应用)的卖家(或称万邑联账户)将通过“授权链接”进行万邑联账户权限授权。
  • 3.授权后您的ERP系统(应用)将获得客户的access_token/token码(有时效限制),获取到授权码(token)即具备访问物流接口和万邑联账户数据的权限。

创建应用

1.访问开发者网站,在页面导航栏中点击“登陆”,进入登陆页面。去登录

2.填写已注册的开发者账户或使用万邑联账户和密码,并正确填写“验证码”,之后点击【登录】。

  • “开发者账户”:指通过开发者网站进行注册的开发账户。
  • “万邑联账户”:指万邑通(Winit)提供给卖家的万邑联系统的账户。第一次使用这个账户登录开发者平台时,需要提交开发者信息。

3.登录后,进入开发者控制台,进入我的应用菜单,
首先创建应用,点击右侧页面中的【添加】,弹出新增应用的窗口,依次填写应用所需信息,点击【确定】即可创建应用。

  • “应用名称”:自定义的应用名称;
  • “应用分类”: 1. 第三方软件供应商,请选择公共平台,2. 自主开发ERP系统卖家,请选择自有平台;
  • “应用图标”:上传本地系统的图标,系统logo或公司logo小图标;
  • “应用Code”: 指应用的平台代码,API调用时基础参数platfrom的值,创建后不可以修改。

列表字段说明:

  • “状态”:完成创建应用即是“已开通授权”状态,暂不进行应用审核;
  • “用户”:显示已经绑定在您的应用中的卖家万邑联账户数量,点击可跳转至“我的用户”页面。
  • “默认授权”:默认可调用物流接口的权限范围。
  • “操作“:管理应用:编辑删除应用,进行开发配置,订阅推送消息等

4.进入管理应用页面,完成开发配置

  • client_id:应用的唯一标识码
  • client_secret:应用的密钥
  • 授权链接:链接需配置后生成,您只需复制并在您的应用中将此链接制成供卖家点击的按键即可,卖家使用万邑联账户进行登陆验证完成授权

    授权回调方式配置

  • “回调方式”:1、静态回调,支持默认回调地址及自定义回调地址;2、动态回调,指服务器请求,需返回成功码

  • “回调页面URL”: 指在卖家授权时,万邑通(Winit)签权服务器返回给您授权码“access_token/token”,开发者用于接收的URL。
    • 使用默认回调地址,即不用填写使用万邑联的默认的回调地址,一般用于不便于使用URL地址接收授权码情形(如您的ERP系统是C/S结构的),卖家授权后直接将授权展示在签权服务器的页面上,卖家可复制粘贴。
    • 使用自定义回调地址,静态回调和动态回调,都会返回username(万邑通注册账号)、access_token;区别,静态回调卖家授权成功后浏览器会重定向,动态回调仅提示卖家授权成功

卖家授权&token获取

1、卖家点击上述“授权链接”跳转至授权页面,使用万邑联账户进行授权的界面,如下:
授权成功后,您可以从页面或者URL中的access_token参数获取到卖家的token,在API调用时,需要使用该token值。
account账号即API调用时传输的appkey



2、卖家也可登陆万邑联系统,进入【万邑联-个人中心-系统设置-获取Token】页面,获取token

  • 卖家可解除已授权的应用或重新授权操作
  • 若卖家刷新token,历史授权的所有应用将失效(需重新授权)

管理应用

1、编辑
2、删除::绑定在应用上的卖家万邑联账户为零时,才可以进行删除

点击“我的用户”,暂只支持显示您的应用已经绑定的卖家万邑联账户信息。

列表字说明:

  • “绑定账户”:卖家进行授权的万邑联账户。
  • “绑定时间“:卖家进行授权的时间。
  • “有效时间”:一次授权默认的授权码有效期为1.5年,卖家可以登陆 “万邑联->个人中心->授权管理”在有效期到来前进行【继延】或【解除】授权。
  • “状态”:默认为“已经开通授权”,卖家解除授权后为失效状态。