Skip to main content

查询商品列表

接口Method

hotel.goods.search

请求BizContent参数

参数名示例值参数类型参数描述
hotelId7374430210Long酒店id。说明：如果传入该参数，则无需传入iotId、productKey和deviceName。如果您同时传入hotelId和iotId、productKey与deviceName的组合，则以hotelId为准。
iotId234133String要查询的设备id。物联网平台为该设备颁发的id，设备的唯一标识符。说明：如果传入该参数，则无需传入productKey和deviceName。iotId作为设备唯一标识符，和productKey与deviceName组合是一一对应的关系。如果您同时传入iotId和productKey与deviceName组合，则以iotId为准。
productKeyglog6H2zlgRString要查询的设备所隶属的产品productKey。说明：如果传入该参数，需同时传入deviceName。
deviceNamesasq12String要查询的设备名称。说明：如果传入该参数，需同时传入productKey。
goodsIds-String Array查询商品的id集合，若为空，则查询所有商品
{
    "hotelId": 7374430210,
    "iotId": "234133",
    "productKey": "glog6H2zlgR",
    "deviceName": "sasq12",
    "goodsIds": [
        "426007374430210"
    ]
}

成功响应示例

参数名示例值参数类型参数描述
hotelId7374430210Long酒店id
goodsList-Array商品集合
goodsList.goodsId1233String商品Id
goodsList.name苹果String商品名称
goodsList.unit个String单位，如：瓶（500ml）
goodsList.imageUriswww.meituan.comString Array商品图片地址集合
goodsList.categoryName日常用品String分类名称
goodsList.count3int商品库存
goodsList.price100int商品单价,单位为分
goodsList.purchaseLimitQuantity2Integer单次下订单时该商品限购的数量，为0或为空则不限制购买数量
goodsList.order1Integer商品排序
{
    "code": 0,
    "message": "成功",
    "data": {
        "hotelId": 7374430210,
        "goodsList": [
            {
                "goodsId": "1233",
                "name": "苹果",
                "unit": "个",
                "imageUris": ["www.meituan.com", "www.meituan1.com"],
                "categoryName": "酒店客房",
                "count": 3,
                "price": 100,
                "purchaseLimitQuantity":2,
                "order":1
            }
        ]
    }
}

错误响应示例

{
     "code": 4000,
     "message": "鉴权失败",
     "data": null
}