## 获取商品单条信息(goodsRead) >[info] 场景说明:获取商城在售的商品单条信息。 ### 是否需要获取用户TOKEN `否` ***** ### 请求地址 ``` POST http://api.xxx.com/goods/read ``` ### 公共请求参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | 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 | | querydesc | boolean | 可选 | 是否获取商品描述,默认:false | ### 请求示例 ``` { "appid": "您的APPID", "version": "v3", "sign_type": "md5", "timestamp": "2020-8-10 12:00:00", "format": "json", "sign": "op0987yhjmngt54rtg2wgdfvcder2765", "params": { "goods_id": 1, "querydesc": true } } ``` ***** ### 公共返回参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | code | integer | 必须 | 0=成功,其它值代表请求失败的错误代码,请参考:[公共错误码](response-code.md) | | message | string | 必须 | 请求成功/失败的描述信息 | | data | array | 必须 | 返回结果,如果没有数据则返回空 | 返回`data`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | goods\_id | integer | 必须 | 商品ID | | goods\_name | string | 必须 | 商品名称 | | cate\_id | integer | 必须 | 分类ID | | cate\_name | string | 必须 | 分类名称 | | store\_id | integer | 必须 | 店铺ID | | store\_name | string | 必须 | 店铺名称 | | brand | string | 可选 | 品牌 | | default\_spec | integer | 必须 | 规格ID,默认SKU | | spec\_name\_1 | string | 可选 | 规格1名称 | | spec\_name\_2 | string | 可选 | 规格2名称 | | spec\_qty | integer | 必须 | 规格数量,最多2个规格 | | price | decimal | 必须 | 默认SKU的商品价格(非促销价格) | | mkprice | decimal | 可选 | 市场价格 | | stock | integer | 必须 | 默认SKU库存量 | | default\_image | string | 必须 | 商品主图 | | dt\_id | int | 可选 | 运费模板ID | | description | text | 可选 | 商品描述,当querydesc=true时必填 | | recommended | integer | 可选 | 是否为推荐商品 | | views | integer | 可选 | 点击量 | | sales | integer | 可选 | 销售量 | | collects | integer | 可选 | 收藏量 | | comments | integer | 可选 | 评论量 | | becollected | boolean | 可选 | 当前登录用户是否收藏过该商品 | | \+ integral | array | 必须 | 商品积分策略 | | └ enabled | boolean | 必须 | 积分功能是否可用 | | └ exchange\_rate | decimal | 可选 | 积分兑换比率,积分功能可用的时候必传 | | └ exchange\_integral | integral | 可选 | 该商品可允许抵扣的积分值,积分功能可用的时候必传 | | └ exchange\_money | decimal | 可选 | 抵扣的金额,积分功能可用的时候必传 | | └ give\_integral | integer | 可选 | 购买该商品获得的积分值,积分功能可用的时候必传 | | add\_time | string | 必须 | 商品发布时间,格式:yyyy-mm-dd hh:ii:ss | ### 返回数据示例 ``` { "code": 0, "message": "成功", "data": { "goods_id": 1, "goods_name": "Midea/美的 BCD-213TM(E) 节能静音家用三开门小冰箱小型电冰箱", "cate_id": 1219, "cate_name": "冰箱", "store_id":2, "store_name": "演示店铺", "brand": "美的", "default_spec": 1, "spec_name_1": "颜色", "spec_name_2": "尺码", "spec_qty": 2, "price": 149.99, "mkprice": "200", "stock": 589, "default_image": "http://www.xxx.com/data/files/store_2/goods/20181121212111599.jpg", "dt_id": 2, "description": "商品描述", "recommended": 1, "views": 100, "sales": 20, "collects": 89, "comments": 5, "becollected": true, "integral": { "enbaled": true, "exchange_rate": 0.1, "exchange_integral": "90", "exchange_money": 0.9, "give_integral": 100 }, "add_time": "2020-1-9 15:40:49" } } ```