文档中心
创建开放应用及卖家授权操作说明
更新时间: 2018-01-25 18:37:50 访问次数:4095
定义

基于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.访问开发者网站(http://developer.winit.com.cn/)在页面导航栏中点击“登陆”,进入登陆页面。

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

  • 开发者账户”:指通过开发者网站(developer.winit.com.cn)进行注册的开发账户。
  • “万邑联账户”:指万邑通(Winit)提供给卖家的万邑联系统(https://www.winit.com.cn/Manage/)的账户,第一次使用这个账户登陆时,要提交开发者信息。

3.步骤2点击【登陆】后,进入开发者控制台,左侧提供【我的应用、我的用户】菜单(下图1),首先我们创建应用,点击右侧页面中的【添加】,弹出新增应用的窗口(下图2),依次填写应用所需信息,点击【确认】即可创建应用。

  • “应用名称”:自定义的应用名称;
  • “应用分类”: 1. 第三方软件供应商,请选择公共平台,2. 自主开发ERP系统卖家,请选择自有平台;
  • “应用图标”:上传本地系统的图标,系统logo或公司logo小图标;
  • “回调页面URL”: 指在卖家授权时,万邑通(Winit)签权服务器返回给您授权码“access_token/token”,开发者用于接收的URL。
    注:使用默认回调地址,即不用填写使用万邑联的默认的回调地址,一般用于不便于使用URL地址接收授权码情形(如您的ERP系统是C/S结构的),卖家授权后直接将授权展示在签权服务器的页面上,卖家可复制粘贴。
  • “应用Code”(platform): 指应用的平台代码,API调用时基础参数platfrom的值,创建后不可以修改。
  • “说明”:自定义应用的备注。

4.步骤3完成创建应用后,在【我的应用】右侧列表页面,将会列出所有应用。

列表字段说明:

  • “状态”:完成创建应用即是“已开通授权”状态,暂不进行应用审核;
  • “参数“:
  • 1. client_id:应用的唯一标识码
  • 2. client_secret:应用的密钥;
  • “授权链接”:点击“点击查看”会弹出窗口显示,链接的组成见下图,您只需复制并在您的应用中将此链接制成供卖家点击的按键即可,链接跳转至卖家使用万邑联账户进行登陆验证完成授权的界面。

    附注:卖家点击上述“授权链接”跳转至授权页面,使用万邑联账户进行授权的界面,如下。

    授权成功后,您可以从页面或者URL中的access_token参数获取到卖家的token,在API调用时,需要使用该token值。

    account账号即API调用时传输的appkey

  • “用户”:显示已经绑定在您的应用中的卖家万邑联账户数量,点击可跳转至“我的用户”页面。
  • “默认授权”:默认可调用物流接口的权限范围。
  • “操作“:
    • a.编辑:修改已经创建应用的信息,可修改的信息请见下图,“应用Code”不可修改已经隐藏。

    • b.删除:仅绑定在应用上的卖家万邑联账户为零时,才可以进行删除。

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

列表字说明:

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