/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 | 否 | 搜索关键词 |
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); }