创建开放应用及卖家授权
更新时间： 2018-01-25 18:37:50 访问次数：16249
基于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.填写已注册的开发者账户或使用万邑联账户和密码，并正确填写“验证码”，之后点击【登录】。
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年，卖家可以登陆 “万邑联->个人中心->授权管理”在有效期到来前进行【继延】或【解除】授权。
- “状态”：默认为“已经开通授权”，卖家解除授权后为失效状态。
关键词
