新手接入指南
更新时间： 2023-08-07 11:47:53 访问次数：28235
注册开发者账户
首先，开始对接API之前，您需注册成为开发者账户，拥有开发者账户才具备调用API权限。
- 如果您已经拥有万邑联系统账户，可以直接使用万邑联账户登录（首次登陆需补充开发者账户信息）
- 如果您没有万邑联系统账户，可以注册开发者后，使用开发者账户登录。立即注册
创建应用&应用授权
登陆开发者管理后台，创建开发者应用（通常指ERP系统，卖家将授权token给应用从而获得访问数据权限），获得卖家绑定万邑联账户的授权链接并完成授权操作
- 创建应用可获取接口请求的基本参数信息：platform、Client_ID、Client_Secret
- 授权操作获取万邑联账户信息：app_key、token
接口调试
对接准备
- 了解接口调用的基础参数和签名认证方法。签名认证获取基本参数信息：sign、client_sign
- 了解测试相关信息：沙箱环境与正式环境。获取API调用地址。
注意：沙箱环境与正式环境的调用地址、创建应用的菜单及应用基本参数和事件订阅url、卖家账户token等信息都不相同。上线前请替换为正式环境信息
| 项目 | 沙箱环境 | 正式环境 |
|---|---|---|
| 万邑联（卖家网站） | https://sandboxseller.winit.com.cn/ 帐户、密码详见开放平台 |
https://seller.winit.com.cn/ |
| 开放平台（开发者账户） | https://developer.winit.com.cn |
https://developer.winit.com.cn |
| API调用地址 | https://sandboxopenapi.winit.com.cn/openapi/service app_key：rebecca Token：89435277FA3BA272DE795559998E- platform：使用万邑联账号或开发者账号登录开发者平台在菜单【沙箱测试-沙箱应用】创建的应用code client_id：在菜单【沙箱测试-沙箱应用】创建应用的client_id client_secret：在菜单【沙箱测试-沙箱应用】创建应用的client_secret sign：根据正序入参MD5的签名认证 client_sign：根据正序入参MD5的签名认证 |
https://openapi.winit.com.cn/openapi/service app_key：万邑联账号，若无账号请先注册 Token：登录万邑联-个人中心-系统设置-获取token。或通过卖家授权获取 platform：使用万邑联账号或开发者账号登录开发者平台在菜单【我的应用】创建的应用code client_id：在菜单【我的应用】创建应用的client_id client_secret：在菜单【我的应用】创建应用的client_secret sign：根据正序入参MD5的签名认 client_sign：根据正序入参MD5的签名认证 |
| 事件订阅 | 在菜单【沙箱测试-沙箱应用-管理】中配置的url 注：沙箱测试事件订阅的URL需联系客服申请访问权限 |
在菜单【我的应用-管理】中配置的url |
确认API
确认您需对接的物流服务，并了解对接API的次序
API字典
1、海外仓储：商品 入库 出库 退货 库存
2、全球直发快递：ISP-万邑邮选
3、尾程联盟：LMA
开发
查看SDK进行开发。 SDK/Demo
测试
使用开发者平台提供的工具进行测试
- 接口测试：在线接口调用测试工具，支持沙箱和正式环境接口调用测试。接口测试工具
- 沙箱测试：登录开发者网站创建一个属于自己的应用，进而用这个应用对应的参数进行开发和联调，沙箱环境无需再注册万邑通账号和开发者账号，切换到正式环境时替换为正式环境对应的client_id，client_secret，platform，appkey，token即可。查看沙箱操作说明
- 沙箱用例：沙箱测试时，部分流程需要WINIT协助审核或走单情况，可执行沙箱用例，目前支持执行的用例如下：
- 注册商品审核
- 入库单状态流转
- 出库单状态流程
- 部分流程触发的订阅事件推送
完成上线
上线并投入使用
