文档中心
新手接入指南
更新时间: 2023-08-07 11:47:53 访问次数:35099

注册开发者账户

首先,开始对接API之前,您需注册成为开发者账户,拥有开发者账户才具备调用API权限。

  1. 如果您已经拥有万邑联系统账户,可以直接使用万邑联账户登录(首次登陆需补充开发者账户信息)
  2. 如果您没有万邑联系统账户,可以注册开发者后,使用开发者账户登录。立即注册

《注册开发者账户 操作手册》

创建应用&应用授权

登陆开发者管理后台,创建开发者应用(通常指ERP系统,卖家将授权token给应用从而获得访问数据权限),获得卖家绑定万邑联账户的授权链接并完成授权操作

  1. 创建应用可获取接口请求的基本参数信息:platform、Client_ID、Client_Secret
  2. 授权操作获取万邑联账户信息:app_key、token

《基础参数说明》 | 《创建开放应用及卖家授权操作说明》

接口调试

对接准备

  1. 了解接口调用的基础参数和签名认证方法。签名认证获取基本参数信息:sign、client_sign

基础参数 | 签名认证 | 签名认证工具

  1. 了解测试相关信息:沙箱环境与正式环境。获取API调用地址。

    注意:沙箱环境与正式环境的调用地址、创建应用的菜单及应用基本参数和事件订阅url、卖家账户token等信息都不相同。上线前请替换为正式环境信息

沙箱自测 | 接口测试工具

项目 沙箱环境 正式环境
万邑联(卖家网站) https://sandboxseller.winit.com.cn/
帐户、密码详见开放平台
https://seller.winit.com.cn/
开放平台(开发者账户) https://developer.winit.com.cn
原沙箱地址已停止服务https://sandboxdeveloper.winit.com.cn/账号rebecca密码888
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

测试

使用开发者平台提供的工具进行测试

  1. 接口测试:在线接口调用测试工具,支持沙箱和正式环境接口调用测试。接口测试工具
  2. 沙箱测试:登录开发者网站创建一个属于自己的应用,进而用这个应用对应的参数进行开发和联调,沙箱环境无需再注册万邑通账号和开发者账号,切换到正式环境时替换为正式环境对应的client_id,client_secret,platform,appkey,token即可。查看沙箱操作说明
  3. 沙箱用例:沙箱测试时,部分流程需要WINIT协助审核或走单情况,可执行沙箱用例,目前支持执行的用例如下:
    1. 注册商品审核
    2. 入库单状态流转
    3. 出库单状态流程
    4. 部分流程触发的订阅事件推送

完成上线

上线并投入使用