/goods/details(获取商品详情)
请求地址:
| 示例地址 | 描述 |
| https://{xxx.com}/goods/details | 地址中的xxx.com为示例,请在会员中心的 资料设置 中查看ApiHost。 |
公共请求参数:
| 名称 | 类型 | 必须 | 描述 |
| uid | Number | 是 | 账号UID,在会员中心的 资料设置 中查看。资料中的ID号包括了站点ID和账号UID,例如:111-10088,其中111是站点ID,10088是账号UID,请勿混淆。 |
| t | Number | 是 | 秒级时间戳 |
| sign | String | 是 | 签名( 查看签名算法 ) |
* 登录的情况下,返回的价格是当前账号的下单价格!
请求参数:
| 名称 | 类型 | 必须 | 描述 |
| goods_id | String | 是 | 商品ID |
响应参数:
{
"code": 200,
"msg": "success",
"data": {
"success": true,
"goods": {
"goods_id": 100350, // 商品ID
"min_price": "8.88", // 当前商品vip最低价
"my_price": "8.88", // 当前账号下单价格
"kuaidi_price": "8.88", // 快递价格(上面的价格已经包括邮费)
"title": "商品标题", // 商品标题
"gyl": 1, // 1.代表无需验证手机和店铺就可以下单; 0.否
"imgurl": "xxx.jpg!200x200", // 商品主图
"yuan": "4",
"fen": "96",
"sheng": "广东", // 仓库所在省
"cangku": "广州花都", // 仓库名称
"ckid": 101, // 仓库ID
"kucun": 0, // 商品总库存
"exclusive_stock": "0", // 当前账号锁定库存数量
"original": "15.06", // 商品原价
// 每个vip对应的价格
"vip_money": {
"vip1": "5.01",
"vip2": "4.96",
"vip3": "4.91",
"vip4": "4.86"
},
"special_price": 0, // 当前账号的特价
// 具体包邮的快递价格
"express_price": [
{
"yfid": 826, // 没有参考价值(内部使用)
"pzid": 762, // 快递配置ID(下单时需要)
// 每个vip对应的价格
"vip": {
"vip1": "5.27",
"vip2": "5.22",
"vip3": "5.17",
"vip4": "5.12"
},
"shop_type": 1, // 获取对应电商平台的单号
"tool_code": 3, // 使用打单工具(1.悦己/酷麦 2.易通 3.益店)
"price": "1.40", // 快递价格
// 快递信息
"kuaidi": {
"kdid": 102, // 快递ID
"name": "中通快递", // 快递名称
"icon": "/icon/zhong_tong.png" // 快递图标
}
}
],
/ 商品下的规格列表
"sku_list": [
{
"sku_id": 800093, // 规格SkuID(下单时需要)
"sku_key": "SKU-0", // 商品下的规格值
"sku_code": "H1-1-09-1", // 商品规格编码
"xiangou": 0,
"sku_name": "颜色随机/10支/1把", // 规格名称
"special_price": "0", // 当前账号的特价
"stock_quantity": "9499", // 当前库存数量
"exclusive_stock": 0, // 账号锁定库存数量
"selling_volume": 18037, // 销量
"sku_price": "3.82", // 规格价格(加上快递价格就是下单价)
// vip对应的下单价格
"vip": {
"vip1": "5.01",
"vip2": "4.96",
"vip3": "4.91",
"vip4": "4.86"
},
// vip对应的规格价格
"vip2": {
"vip1": "3.87",
"vip2": "3.82",
"vip3": "3.77",
"vip4": "3.72"
},
"original2": "3.92", // 原价
"status": 1, // 状态,1.正常 0.下架
"buy_price": 0, // 忘了是啥了
"image": "xxx.jpg" // 规格图片
}
],
// 支持的店铺类型列表
"shop_type_list": [
{
"name": "京东",
"icon": "gyl-jingdong",
"type": "jd",
"id": 4 // 电商平台类型ID
},
],
/ 支持的快递列表
"express_list": [
{
"kdid": 103, // 快递ID
"icon": "/icon/yun_da.png",
"name": "韵达快递",
"price": "5.12", // 当前快递包邮最低价格
"eprice": "1.30" // 当前快递最低价格
},
],
"nSkuList": [],
// 轮播图
"lun_bo_tu": [
{
"imgpath": "\/image\/202311\/12\/77bbbce014da2355.jpg",
"width": "800",
"height": "800",
"image": "https:\/\/static-image.1121.cn\/image\/202311\/12\/77bbbce014da2355.jpg"
}
],
"gui_ge": [
{
"name": "规格",
"children": [
{
"name": "颜色随机\/10支\/1把",
"id": 0,
"sort": "0"
}
]
}
],
"shu_xing": [
{
"name": "风格",
"value": "北欧风格"
}
],
"xiang_qing": [
{
"imgpath": "https:\/\/static-image.1121.cn\/image\/202311\/12\/d435063f2a358b80.jpg",
"width": 750,
"height": 750
}
],
"selling_volume": "1.5万+",
"collectData": {
"scid": null,
"sku_id": null,
"shop_type": null,
"kdid": null
},
"isCollect": false,
"collect": "70+"
},
"cangku": {},
"remaiList": [],
"vipCode": 0
}
}
说明:
1. 通过sku_id区分不通的商品规格,下单时只需要sku_id即可,不需要商品ID(goods_id)。
2. 关于pzid,是通过:店铺类型(shop_type)、快递(kdid)、打单工具(tool_code),这3个参数确认的。打单工具(tool_code)这个参数有什么就选什么,不用纠结怎么选。建议有代码为1就传1。店铺类型(shop_type)、快递(kdid)这两个参数,根据自己的需求选择。通过这3个参数去 express_price 筛选出 pzid,筛选不出,就代表不支持。
PHP示例代码:
function test_api(){
$url = 'http://xxx.com/goods/details';
$uid = '188888';
$mobile = '18899999999';
$apikey = '8d2e89203dd3b2d1cbad6e853101da99';
$t = time();
$post = [];
$post['t'] = $t;
$post['uid'] = $uid;
$post['sign'] = md5(md5(strtolower($apikey).$mobile.$uid.$t));
$post['goods_id'] = "100001";
$resp = self::sendPost( $url, $post, 'POST', [] );
return json($resp);
}