搜索
微信客服
获取商品详情(/goods/details)
更新于: 2024-04-28 18:38:53 阅读数: 1276

/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);
}