商品采购统一下单接口(url时效5分钟
接口地址
https://activity.m.duiba.com.cn/gaw/supply/purchase
接口支持http或https协议访问,响应内容中链接的协议头也会自适应转换。
注意: 若接口返回“发生系统错误”(响应码:9999999)或接口网络异常(如超时等异常情况),请勿直接认为下单失败,需调用 订单状态查询接口 ,确认订单状态。
请求方式: post
注意: 下单接口为form表单形式请求提交,使用post请求,且勿使用json格式请求发送数据,否则接口会报错
请求参数:
参数参数 | 类型 | 是否必填 | 限制长度 | 描述 |
---|---|---|---|---|
appKey | string | Y | 255 | 应用唯一标注 |
timestamp | string | Y | 20 | 1970.1.1开始的毫秒数 |
sign | string | Y | 255 | 签名(详见签名规则) |
appItemId | long | Y | 20 | 商品id |
skuId | long | Y | 20 | 商品skuId,注:如果商品为话费请填0 |
thirdOrderNum | string | Y | 255 | 第三方订单号 |
account | string | N | 32 | 商品为虚拟商品充值类,则传对应的充值账号 |
wxCouponValue | long | N | 20 | 微信立减金-面额>=100,单位分,不定额立减金时必传 |
wxCouponMinimum | long | N | 32 | 微信立减金-发放门槛>=101,单位分,不定额立减金时必传 |
phoneDegree | long | N | 20 | 商品为多档位话费时,话费的档位面额,单位分 |
phone | string | N | 32 | 实物和话费商品必传;实物为收货人手机号;话费为充值手机号 |
address | string | N | 255 | 实物商品收货详细地址(实物商品必传) |
province | string | N | 255 | 实物商品收货地址 省份(实物商品必传) |
city | string | N | 255 | 实物商品收货地址 市(实物商品必传) |
district | string | N | 255 | 实物商品收货地址 区、县(实物商品必传) |
street | string | N | 255 | 实物商品收货地址 街道 |
name | string | N | 32 | 实物商品收货人姓名(实物商品必传) |
响应参数:
参数参数 | 类型 | 是否必填 | 限制长度 | 描述 |
---|---|---|---|---|
success | boolean | Y | 是否成功 | |
code | string | Y | 255 | 参见‘响应码明细表’ |
desc | string | Y | 255 | 参见‘响应码明细表 |
timestamp | string | Y | 20 | 系统时间戳 |
data | object | Y | 参见‘data明细表’ |
响应码明细表:
code | desc |
---|---|
0000000000 | 成功 |
9999999 | 发生系统错误 |
1100001 | appKey不能为空 |
1100002 | appKey错误 |
1100003 | 签名验证失败 |
1100004 | 第三方订单号重复 |
1100005 | appItemId不能为空 |
1100006 | skuId不能为空 |
1100007 | 实物商品收货信息不能为空 |
1100008 | 第三方订单号不能为空 |
1100009 | 商品不存在 |
1100010 | 商品已下架 |
1100011 | 不支持购买自有商品 |
1100012 | 下单失败稍后再试(库存不足) |
1100013 | 订单不存在 |
1100014 | 签名不能为空 |
1100015 | 时间戳不能为空 |
1100016 | 请求已过期 |
1100017 | appItemIds错误 |
1100018 | 非兑吧采购商品 |
1100019 | 无权访问该商品 |
1100020 | 该地区限制下单 |
1100021 | 该商品该地区不发货 |
1100022 | 虚拟商品充值账号不能为空 |
1100023 | 当前app无接口使用权限 |
1100024 | 今日采购优惠券已达上限 |
1100025 | 当前商品库存不足 |
1100026 | 多档位话费的档位不能为空 |
1100027 | 话费商品充值手机号不能为空 |
1100028 | 手机号码归属地查询异常 |
1100029 | 话费价格非法,无法进行充值兑换 |
1100030 | 话费商品档位配置有误 |
1100031 | 手机号无合适供应商 |
1100032 | 多档位话费的档位有误 |
1100033 | 该商品不支持采购,请联系运营或技术支持 |
1100034 | 立减金面额和门槛不可为空 |
1100035 | 立减金不支持自定义面额和门槛 |
data明细表
参数参数 | 类型 | 是否必填 | 限制长度 | 描述 |
---|---|---|---|---|
orderNum | string | Y | 255 | 兑吧订单号 |
响应示例:
{
"success":true,
"code":"0000000000",
"desc":"OK",
"timestamp":1561392321796,
"data":{
"orderNum":"123032948572"
}
}