开发规范

调用说明

本开放平台基于 HTTP 协议开发,用户只需要按照开发规范拼装正确的 URL 以及 参数 ,即可请求成功。

调用入口

系统级参数

名称 类型 是否必填 描述
token string 用户认证信息,请前往门户权限页面获取
timestamp long 时间戳
businessId string 业务ID

注:所有请求都需要带上系统级参数,系统级参数不区分请求方式,统一使用query parameters方式传递。

示例

https://scc.litb.cn/{具体api}?
token=你的token
&timestamp=发起请求时间戳
&businessId=你的业务id

业务参数

API调用除必须包含公共参数外,如果API本身有业务级的参数也必须传入。

返回值

说明:返回值统一为JSON格式

名称 类型 描述
success boolean 结果状态,true请求成功,false请求失败
detail string 错误信息
data object 如果有额外信息,会通过该属性返回
status int 错误码

示例:

{ "success": true, "detail": "", "data": 8286, "status": 0 }

错误码

错误码 错误内容 描述
40100 认证失败
40101 没有检查到token
40102 签名校验失败
40103 参数错误 系统参数
40104 业务ID不能为空
40105 时间戳格式错误
40106 时间戳格式错误 请使用当前时间的时间戳
40107 请勿重复提交 并发拒绝
40108 无该接口权限
40109 token无接入权限 token被关闭
40110 token对应账户类型错误 token账户类型不匹配
40001 参数错误 业务参数
10001 错误商家编码,请修改后重试
10002 没有权限操作当前商家编码
10003 在预处理清单处有待处理订单,请先去预处理清单界面处理
10004 部分商品报缺存在异常
10005 超过单次报缺上限
10006 非主供商品不能报缺,请删除后重试
10101 查无此发货单
10102 时间格式错误
10103 超出单次查询个数上限
10104 ExpressId填写错误,参考发货API文档支持的快递公司
10105 预计到货日期格式填写错误,参考yyyy-MM-dd
10106 预计到货日期不能小于当前日期
10107 匹配到错误的商家SKU编码
10108 存在异常状态采购单无法发货,请先到门户处理异常
10109 未查询到需要发货的采购单行
10110 存在多个收货仓库
10111 存在不同收货模式,不能发货
10112 发货数量不能小于1个且不能超过采购数量,不能发货
10113 未填写快递单号,不能发货
10114 已确认发货单,不允许继续添加单行
10115 没有可发货的单行
10116 更新时间必须包含起止时间
10117 只有草稿状态下的发货单才能修改单行数量
10118 存在不属于自己的SKU
10119 不能维护长度超过32的商家SKU编码
10120 部分商家SKU编码维护失败
10121 产品信息不存在
10301 参数存在重复的sku编码
10302 缺少商家sku编码
10303 库存数量必须大于0
10304 缺少库存参数
10305 当前供应商未开启库存管理
10306 库存数量必须大于等于0
10307 不能超过每次最大导入库存数量
10401 配仓每次调用只能配1个采购单行
10402 单行不满足状态或不存在
10403 无商家SKU编码
10404 无现货库存
0 执行成功
-1 服务器内部错误,请稍后重试