1. 对接信息

名称 数值 说明
app_key —— 分配给应用的AppKey,用于标记一个唯一的接入方(随对接文档邮件发放)
app_secret —— Oauth2颁发的动态令牌(随对接文档邮件发放)
账号(merchant) —— 三维度分配的接入账号,用户获取token以及生成订单时打标记(联系三维度运营获取)
密码(password) —— 三维度分配的接入密码(联系三维度运营获取)
token —— ——

1.1 接口规范

请求格式:

所有请求格式为json,请求方式为post请求,返回格式json。

接口参数区分大小写,非必填参数则用“”代替, 其中reqParam 代表自定义参数,其它为公共参数。根据接口参数来定。

sign 签名算法参考“签名生成”章节

例子:

http://xxxxxx/demo/findToken?param_json={"sign":"22678e2268ba83a5bb8982f2071928900058d9b6","merchant":

"test","token":"daaf43b2a943cda8","reqParam":{"tokenStatus":"overdue"},"curTime":"2017-05-19

11:25:41","version":"1.0.1","appKey":"526fffc743c07311","secreKey":"7681A357FCABFEC7"}

签名生成:

签名过程分为两步,首先是将原始参数按照规则拼接成一个字符串,然后再将字符串根据签名算法生成签名字符串sign参数原始字符串的拼接规则:

一) 对于sign交互的参数:json 数据(不包括sign字段), json串+secreKey

生成签名的过程如下:

一) 对拼接的参数字符串S1通过SHA1算法计算摘要,得到字符串S2并进行base64转码,得到签名字符sign.

注意事项:

  • 参数列表中的sign字段不参与签名
  • 为了简化处理,json标签也参与签名
  • 参数区分大小写
  • 文档接口示例双引号有中文符号
  • 所有价格都已分为单位

1.2 拼装API请求

将所有参数值转换为UTF-8编码,然后拼装,通过post请求进行访问。

注意:以下系统参数为所有接口服务的公共请求参数(除reqParam为自定义参数)

参数说明:

名称 类型 是否必须 描述
merchant String 商户号
secreKey String 分配给商户的secreKey
appKey String 分配给商户的AppKey
token String 分配给商户的token
version String 版本 1.0.1
curTime String 请求时间
reqParam String 自定义参数,如果无参数:"reqParam":{}, 有参数则"reqParam":{"tokenStatus":"overdue"}

http://xxxxxx/acccount/getToken?param_json={"sign":"22678e2268ba83a5bb8982f2071928900058d9b6","merchant":"test","token":"daaf43b2a943cda8","reqParam":{"tokenStatus":"overdue"},"curTime":"2017-05-19 11:25:41","version":"1.0.1","appKey":"526fffc743c07311","secreKey":"7681A357FCABFEC7"}

测试环境:

http://120.55.76.110:8920/acccount/getToken?param_json={"sign":"22678e2268ba83a5bb8982f2071928900058d9b6","merchant":"test","token":"daaf43b2a943cda8","reqParam":{"tokenStatus":"overdue"},"curTime":"2017-05-19 11:25:41","version":"1.0.1","appKey":"526fffc743c07311","secreKey":"7681A357FCABFEC7"}

1.3 错误码

1.3.1 系统错误码

错误码 错误中文描述 解决方案
1001 成功
1002 失败 Api内部问题
1003 非法请求 检查请求方式是否为post
1004 参数有空 检查param_json参数是否为空
1005 必传参数为空 检查必传参数是否为空
1006 商户数据不存在 检查secreKey,appKey,merchant是否正确(如还有问题则联系对接人员)
1008 token过期 重新获取token(有效期为30天)
1009 验签失败 请检查json数据格式以及阅读接口安全规范
1010 自定义参数不一致 检查reqParam参数是否与接口文档参数一致
1011 缺少secreKey 检查secreKey
1012 缺少appKey 检查appKey是否传递
1010 缺少sign 检查secreKey是否传递
1014 缺少version 检查version是否传递
1015 缺少merchant 检查merchant是否传递
1016 缺少token 检查token是否传递
3024 缺少方法名参数 方法名为必传参数
3025 不存在的方法名或者版本号 请检查方法名和版本号是否已存在并正确

1.3.2 业务错误码

错误码 错误中文描述 解决方案

1.4 接口清单

一级目录 二级目录 接口 接口VOP(实物) 买断业务
更新token 更新token接口
查询商品池编号接口
查询池内商品编号接口
查询商品详细信息接口
查询池内商品编号接口
查询所有图片信息接口
查询商品好评度接口
查询商品区域购买限制接口
查询商品区域是否支持货到付款接口
查询赠品信息接口
运费查询接口(新增)
商品可售验证接口(新增)
获取三维度预约日历
查询商品延保接口
查询分类列表信息接口
查询分类信息接口
价格API接口 批量查询价格(新增)
地址API接口 查询三维度一级地址
查询三维度二级地址
查询三维度三级地址
查询三维度四级地址
库存API接口 批量获取库存接口
消息API接口 信息推送接口
删除推送信息接口
查询余额API接口 统一余额查询接口
查询用户金采余额接口明细
统一下单API接口
下单环节API接口 确认预占库存订单接口
发起支付接口
取消未确认订单接口
查询三维度订单信息接口
订单反查接口
查询配送信息接口
根据运单号查询配送信息接口
对账API接口 新建订单查询接口
查询妥投订单接口
查询拒收订单接口
售后API接口 服务单保存申请
填写客户发运信息
校验某订单中某商品是否可以提交售后服务
根据订单号、商品编号查询支持的服务类型
根据订单号、商品编号查询支持的商品返回三维度方式
根据客户账号和订单号分页查询服务单概要信息
根据服务单号查询服务单明细信息
取消服务单/客户放弃
补充商品相关接口 获取商品详情列表
获取商品类目信息接口
获取商品基本信息
获取商品大字段信息
查询同类产品ids接口
根据组id获取属性id属性名
根据属性id获取属性值名
根据分类id获取属性组id属性组名
根据商品id获取商品保质期信息
根据商品id获取规格参数,属性id属性值属性值id
移动商品介绍查询接口

1.5 API调用流程图

2. 接口明细

进一步了解三维度

如需更深入了解详情,请填写以下信息,我们会尽快安排专业人员与您沟通联系。