/goods/search(获取商品详情)
请求地址:
| 示例地址 | 描述 | 
| https://{xxx.com}/goods/search | 地址中的xxx.com为示例,请在会员中心的 资料设置 中查看ApiHost。 | 
公共请求参数:
| 名称 | 类型 | 必须 | 描述 | 
| uid | Number | 是 | 账号UID,在会员中心的 资料设置 中查看。资料中的ID号包括了站点ID和账号UID,例如:111-10088,其中111是站点ID,10088是账号UID,请勿混淆。 | 
| t | Number | 是 | 秒级时间戳 | 
| sign | String | 是 | 签名( 查看签名算法 ) | 
* 登录的情况下,返回的价格是当前账号的下单价格!
请求参数:
| 名称 | 类型 | 必须 | 描述 | 
| keyword | String | 否 | 搜索关键词(可传商品ID、SkuID,批量查商品ID可用竖线 "|" 隔开,例如:123456|789456) | 
| sort | String | 否 | 排序值(volume:销量从高到低,xinpin:新品,money:价格从低到高,id:商品ID从小到大,update:最新时间从近到远) | 
| pingtai | Int | 否 | 1.淘宝 2.抖音 3.拼多多 4.京东 5.快手 6.视频号 | 
| tool | Int | 否 | 打单工具:1.悦己/酷麦 2.易通 3.益店(需要与pingtai一起使用,单独使用不起作用) | 
| kdid | Int | 否 | 快递ID | 
| province | String | 否 | 搜仓库省份 | 
| city | String | 否 | 搜仓库所在城市,必须与省份一起搜索。 | 
| ckid | Int | 否 | 仓库ID | 
| min | Float | 否 | 最小商品金额(参考值) | 
| max | Float | 否 | 最大商品金额(参考值) | 
| bfb | Int | 否 | 1.免验证商品 0.全部 | 
| id | Int | 否 | 搜索大于此商品ID的商品 | 
| update_time | Int | 否 | 搜索大于此更新时间的商品(秒) | 
| limit | Int | 是 | 每页数量(最多200条) | 
| page | Int | 是 | 页面 | 
响应参数:
{
    "code": 200,
    "msg": "success",
    "data": {
        "success": true,
        "list": [
            {
                "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",	// 商品主图
		"sheng": "广东",        	// 仓库所在省 
		"cangku": "广州花都",    	// 仓库名称 
		"ckid": 101,            	// 仓库ID 
		"kucun": 0,			// 商品总库存 
		"exclusive_stock": "0",    	// 当前账号锁定库存数量 
		"original": "15.06",		// 商品原价 
                "vip_money": {},		// 每个vip对应的价格
                "special_price": 0,		// 当前账号的特价  
                "express_price": [
                    {
                        "yfid": 826,    		// 没有参考价值(内部使用) 
			"pzid": 762,    		// 快递配置ID(下单时需要)
			"vip": {},			// 每个vip对应的价格
			"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,        	// 限购数量,0.代表限购1件
                	"sku_name": "颜色随机/10支/1把",// 规格名称
			"special_price": "0",    	// 当前账号的特价 
			"stock_quantity": "9499",	// 当前库存数量 
			"exclusive_stock": 0,		// 账号锁定库存数量 
			"selling_volume": 18037,    	// 销量 
			"sku_price": "3.82",		// 规格价格(加上快递价格就是下单价)  
                        "vip": { },			// vip对应的下单价格
                        "vip2": { },			// vip对应的规格价格
                        "original2": "3.92",    	// 原价 
			"status": 1,			// 状态,1.正常 0.下架 
			"buy_price": 0, 		// 忘了是啥了 
			"image": "xxx.jpg"		// 规格图片
                    }
                ],
		// 支持的店铺类型列表
                "shop_type_list": [
                    {
                        "name": "快手",
                        "icon": "gyl-kuaishou",
                        "type": "ks",
                        "id": 5
                    }
                ],
		// 支持的快递列表
                "express_list": [
                    {
                        "kdid": 103,
                        "icon": "\/icon\/yun_da.png",
                        "name": "韵达快递",
                        "price": "2.59",
                        "eprice": "1.17"
                    }
                ],
                "nSkuList": []
            }
        ],
        "remai": [],
        "total": 924,
        "vipCode": 4,
        "cangku": []
    }
}
说明:
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/search';
	$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['limit'] = 20;
	$post['page'] = 1;
	$resp = self::sendPost( $url, $post, 'POST', [] );
	return json($resp);
}