## 获取商品SKU列表(goodsSpecs) >[info] 场景说明:根据商品ID获取该商品的所有SKU列表 ### 是否需要获取用户TOKEN `否` ***** ### 请求地址 ``` POST http://api.xxx.com/goods/specs ``` ### 公共请求参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | appid | string | 必须 | 平台提供的唯一APPID | | version | string | 必须 | 接口版本号,固定填:v3 | | sign\_type | string | 必须 | 签名类型,目前只支持md5 | | timestamp | string | 必须 | 发起时间戳,格式为:yyyy-mm-dd hh::ii::ss | | format | string | 必须 | 返回的数据格式,只支持json | | sign | string | 必须 | 请求参数的签名,请参考:[签名规则](signature.md) | | token | string | 必须 | 访问TOKEN | | params | string | 必须 | 请求参数的集合,除公共参数外,所有请求参数都必须放在这个参数中传递,json\_encode后送入 | 应用请求参数`params`格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | goods\_id | integer | 必须 | 商品ID | | spec\_1 | string | 可选 | 根据该规格1的值搜索规格列表 | | spec\_2 | string | 可选 | 根据该规格2的值搜索规格列表 | ### 请求示例 ``` { "appid": "您的APPID", "version": "v3", "sign_type": "md5", "timestamp": "2020-8-10 12:00:00", "format": "json", "sign": "op0987yhjmngt54rtg2wgdfvcder2765", "params": { "goods_id": 1, "spec_1": "红色" } } ``` ***** ### 公共返回参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | code | integer | 必须 | 0=成功,其它值代表请求失败的错误代码,请参考:[公共错误码](response-code.md) | | message | string | 必须 | 请求成功/失败的描述信息 | | \+ data | array | 必须 | 返回结果,如果没有数据则返回空 | | └ list | list | 必须 | 规格列表 | 返回`data->list`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | goods\_id | integer | 必须 | 商品ID | | goods\_name | string | 必须 | 商品标题 | | default\_image | string | 必须 | 商品主图 | | spec\_qty | integer | 必须 | 规格SKU数量 | | spec\_name\_1 | string | 可选 | 规格1名称 | | spec\_name\_2 | string | 可选 | 规格2名称 | | spec\_id | integer | 必须 | 商品规格ID | | spec\_1 | string | 可选 | 规格1的值 | | spec\_2 | string | 可选 | 规格2的值 | | price | decimal | 必须 | SKU价格(非促销价格) | | mkprice | decimal | 可选 | SKU市场价格 | | stock | integer | 必须 | SKU库存 | | sales | integer | 必须 | 商品销量(所有规格) | | image | string | 可选 | SKU图片 | | promotion | array | 可选 | 当有促销价格的时候有值 | 返回`data->promotion`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | price | decimal | 必须 | 促销价格 | | type | string | 必须 | 促销类型,可选值:"limitbuy"=限时促销,"exclusive"=手机专享 | | name | string | 必须 | 促销标题 | | start\_time | string | 可选 | 促销开始时间,type=="limitbuy"时必传,下同 | | end\_time | string | 可选 | 促销结束时间 | | timestamp | integer | 可选 | 结束时间(时间戳) | | \+ lefttime | array | 可选 | 促销剩余时间数组 | | └ d | integer | 可选 | 天数 | | └ h | integer | 可选 | 小时 | | └ m | integer | 可选 | 分钟 | | └ s | integer | 可选 | 秒数 | ### 返回数据示例 ``` { "code": 0, "message": "成功", "data": { "list": [ { "goods_id": 123, "goods_name": "Midea/美的 BCD-213TM(E) 节能静音家用三开门小冰箱小型电冰箱", "default_image":"https://www.shopwind.net/data/files/mall/goods-123.png", "spec_qty": 2, "spec_name_1": "颜色", "spec_name_2": "尺寸", "spec_id": 123, "spec_1": "红色", "spec_2": "L", "price": 199.99, "mkprice: 300.00, "stock": 1000, "sales": 456, "image": "http://www.xxx.com/red-l.jpg", "promotion":{ "price": 159.99, "type": "limitbuy", "name": "双11大促", "start_time": "2020-11-11 00:00:00", "end_time": "2020-11-11 23:59:59", "timestamp": 1605081599, "lefttime": { "d": 0, "h": 10, "m": 20, "s": 30 } } }, { "goods_id": 123, "goods_name": "Midea/美的 BCD-213TM(E) 节能静音家用三开门小冰箱小型电冰箱", "default_image":"https://www.shopwind.net/data/files/mall/goods-123.png", "spec_qty": 2, "spec_name_1": "颜色", "spec_name_2": "尺寸", "spec_id": 125, "spec_1": "红色", "spec_2": "XL", "price": 299.99, "mkprice: 500.00, "stock": 900, "sales": 567, "image": "http://www.xxx.com/red-xl.jpg", "promotion": null } ] } } ```