提供一组与产品相关的服务接口，客户端应用通过本组服务接口可以实现产品信息的查询，包括可配网产品列表、配网引导页信息以及具体产品信息的查询。

根据设备ID查询产品详情

定义描述

path 版本 描述 是否需要登录
/thing/detailInfo/queryProductInfo 1.1.3 查询产品详情信息 否

请求参数

参数 类型 必填 描述
iotId String 是 设备ID

返回参数

参数 类型 必有 描述
productKey String 是 产品的Key
dataFormat String 是 数据格式
  • CUSTOM_FORMAT：透传/自定义格式
  • ALINK_FORMAT：Alink协议
netType String 是 设备入网类型：
  • lora：NET_LORA
  • gprs：NET_CELLULAR
  • wifi：NET_WIFI
  • zigbee：NET_ZIGBEE
  • 蓝牙：NET_BT
  • 以太网：NET_ETHERNET
  • 其他：NET_OTHER
productSecret String 否 产品密钥
nodeType String 是 设备的节点类型：DEVICE，GATEWAY
domain String 否 产品域
name String 是 产品名称
region String 是 地域
ownerDomain String 否 所有者领域
categoryId Long 是 归属品类ID
categoryKey String 否 品类标识符
categoryName String 否 品类名称
accessMethod String 是 访问方式
  • DATA_DIRECT：数据直连
  • AIR_FORWARD：空中转发
  • APP：APP
  • VIRTUAL：虚拟设备
status String 是 产品状态
  • DEVELOPMENT_STATUS：开发中
  • RELEASE_STATUS：已发布
gmtCreate Date 是 创建时间
gmtModified Date 是 修改时间
creator String 是 创建者
modifier String 是 修改者
productId Long 是 产品ID
aliyunCommodityCode String 否 商品码
connectMode String 是 配网方式
rbacTenantId String 是 租户ID

示例

  • 请求示例 
    {
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.1.3",
        "iotToken": "token"
    },
    "params": {
        "iotId": "D95D2429xxxxxxxxF31A2697"
    }
}
  • 正常返回示例 
    {
    "code": 200,
    "data": {
        "accessMethod": "DATA_DIRECT",
        "gmtModified": 1517217645000,
        "modifier": "5030ala9cd20xxxxxxxxc63b454243668090",
        "productKey": "a1IxxxxW",
        "creator": "5030ala9cdxxxxxxxxc63b454243668090",
        "productId": 87634,
        "dataFormat": "ALINK_FORMAT",
        "netType": "NET_WIFI",
        "aliyunCommodityCode": "tmp",
        "productSecret": "tfbMxxxxKKj",
        "nodeType": "DEVICE",
        "gmtCreate": 1517208303000,
        "domain": "a1IxxxxCW",
        "name": "风扇",
        "tenantId": 3312,
        "connectMode": "2,3",
        "region": "cn-shanghai",
        "ownerDomain": "tmp_5030alxxxxxxxx0fbdc63b454243668090",
        "rbacTenantId": "755ED7C7xxxxxxxx026BBC48BF0247",
        "categoryId": 285,
        "status": "RELEASE_STATUS"
    },
    "id": "6aad0b12-2192-xxxx-xxxx-08a2bc0b5c2a"
}

根据产品key查询产品详情

定义描述

path 版本 描述 是否需要登录
/thing/allProductInfo/getByProductKey 1.1.3 根据ProductKey查询产品信息 否

请求参数

参数 类型 必填 描述
productkey String 是 产品Key

返回参数

参数 类型 必有 描述
productKey String 是 产品的Key
dataFormat String 是 数据格式
  • CUSTOM_FORMAT：透传/自定义格式
  • ALINK_FORMAT：Alink协议
netType String 是 设备入网类型：
  • lora：NET_LORA
  • gprs：NET_CELLULAR
  • wifi：NET_WIFI
  • zigbee：NET_ZIGBEE
  • 蓝牙：NET_BT
  • 以太网：NET_ETHERNET
  • 其他：NET_OTHER
productSecret String 否 产品密钥
nodeType String 是 节点类型，DEVICE：设备；GATEWAY：网关
domain String 否 产品域
name String 是 产品名称
region String 是 地域
ownerDomain String 否 所有者领域
categoryId Long 是 归属品类ID
categoryKey String 否 品类标识符
categoryName String 否 品类名称
accessMethod String 是 访问方式
  • DATA_DIRECT：数据直连
  • AIR_FORWARD：空中转发
  • APP：APP
  • VIRTUAL：虚拟设备
status String 是 产品状态
  • DEVELOPMENT_STATUS：开发中
  • RELEASE_STATUS：已发布
gmtCreate Date 是 创建时间
gmtModified Date 是 修改时间
creator String 是 创建者
modifier String 是 修改者
productId Long 是 产品ID
aliyunCommodityCode String 否 商品码
connectMode String 是 配网方式
rbacTenantId String 是 rbac租户ID

示例

  • 请求示例 
    {
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.1.3",
        "iotToken": "token"
    },
    "params": {
        "productKey": "a1xxxxVAH"
    }
}
  • 正常返回示例 
    {
    "code": 200,
    "data": {
        "accessMethod": "DATA_DIRECT",
        "gmtModified": 1517217645000,
        "modifier": "5030alxxxxxxxxfbdc63b454243668090",
        "productKey": "a1IxxxxCW",
        "creator": "5030ala9cdxxxxxxxxc63b454243668090",
        "productId": 87634,
        "dataFormat": "ALINK_FORMAT",
        "netType": "NET_WIFI",
        "aliyunCommodityCode": "tmp",
        "productSecret": "tfbxxxxxxxxqPKKj",
        "nodeType": "DEVICE",
        "gmtCreate": 1517208303000,
        "domain": "a1I0TQKlMCW",
        "name": "风扇",
        "tenantId": 3312,
        "connectMode": "2,3",
        "region": "cn-shanghai",
        "ownerDomain": "tmp_5030ala9cdxxxxxxxxb454243668090",
        "rbacTenantId": "755ED7Cxxxxxxxx26BBC48BF0247",
        "categoryId": 285,
        "status": "RELEASE_STATUS"
    },
    "id": "6aad0b12-2192-xxxx-xxxx-08a2bc0b5c2a"
}

根据品类ID查询产品列表

定义描述

path 版本 描述 是否需要登录
/thing/productInfo/getByCategory 1.1.4 根据品类查询租户创建的所有产品，无需租户ID 否

请求参数

参数 类型 必填 描述
categoryId Long 是 品类ID
rbacTenantId String 否 rbac租户ID

返回参数

参数 类型 必有 描述
productKey String 是 产品的Key
dataFormat String 是 数据格式：0-透传/自定义格式；1-Alink协议
netType String 是 入网类型：0-LORA；3-WIFI；4-:ZIGBEE；5-BT；6-CELLULAR；7-ETHERNET；8-NET_OTHER
productSecret String 否 产品密钥
nodeType String 是 节点类型：0-DEVICE；1-GATEWAY
domain String 否 产品域
name String 是 产品名称
region String 是 地域
ownerDomain String 否 所有者领域
categoryId Long 是 归属品类ID
categoryKey String 否 品类标识符
categoryName String 否 品类名称
accessMethod String 是 访问方式：0-数据直连；1-空中转发；2-APP
status Integer 是 产品状态：0-开发中；1-已发布
gmtCreate Date 是 创建时间
gmtModified Date 是 修改时间
creator String 是 创建者
modifier String 是 修改者
productId Long 是 产品ID
aliyunCommodityCode String 否 商品码
connectMode String 是 配网方式
rbacTenantId String 是 租户ID

示例

  • 请求示例 
    {
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.1.3",
        "iotToken": "token"
    },
    "params": {
        "categoryId": 12
    }
}
  • 正常返回示例 
    {
    "code": 200,
    "data": [{
        "accessMethod": "DATA_DIRECT",
        "gmtModified": 1517562992000,
        "productModel": "niki_test_prodcut_model",
        "modifier": "50a1al58xxxxxxxx201b3f85e2ff9014",
        "productKey": "a1xxxxCf",
        "image": "logo",
        "creator": "50a1alxxxx201b3f85e2ff9014",
        "productId": 95959,
        "dataFormat": "CUSTOM_FORMAT",
        "netType": "NET_CELLULAR",
        "aliyunCommodityCode": "tmp",
        "productSecret": "Y1kxxxxxxxxkCw",
        "nodeType": "DEVICE",
        "gmtCreate": 1517562992000,
        "domain": "a15iEO9rxCf",
        "name": "test_name",
        "tenantId": 21,
        "region": "cn-hangzhou",
        "rbacTenantId": "2BF8238E3xxxxxxxx9C7180BD2CF6",
        "ownerDomain": "tmp_50a1al5xxxxxxxxf3350201b3f85e2ff9014",
        "categoryId": 61,
        "status": "DEVELOPMENT_STATUS"
    }],
    "id": "db13e9ae-c617-xxxx-xxxx-a1e4f43e36ec"
}

查询配网引导信息

定义描述

path 版本 描述 是否需要用户身份的鉴权
/awss/enrollee/guide/get 1.1.3 查询配网引导页的模版定义信息，用于客户端展示友好的配网流程的引导信息 是，客户端SDK需启用身份的鉴权，进行身份认证

请求参数

参数 类型 必填 描述
productKey String 是 productKey

返回参数

参数 类型 必有 描述
productKey String 是 产品Key
helpTitle String 否 帮助标题
dnGuideIcon String 否 配网引导图标
helpCopywriting String 否 帮助文案
buttonCopywriting String 否 按钮文案
dnCopywriting String 否 配网文案
helpIcon String 否 帮助图标
id Long 是 配网引导ID
gmtCreate Date 是 创建时间
gmtModified Date 是 修改时间
creator String 是 创建者
modifier String 是 修改者
rbacTenantId String 是 rbac租户ID

示例

  • 请求示例 
    {
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.1.3",
        "iotToken": "token"
    },
    "params": {
        "productKey": "a1xxxxAH"
    }
}
  • 正常返回示例 
    {
    "code": 200,
    "data": [{
        "gmtModified": 1517476367000,
        "creator": "755ED7CxxxxxxxxC48BF0247",
        "helpTitle": "指示灯没有闪烁？",
        "dnGuideIcon": "http://iotx-ilop.oss-cn-hangzhou.aliyuncs.com/iotx-ilop-portal/p/a12xxxxQfi/networkConfig/1517476344732/timg.jpg",
        "helpCopywriting": "请长按重置3-5秒，确保看到指示灯闪烁后松开",
        "modifier": "755ED7CxxxxxxxxBC48BF0247",
        "buttonCopywriting": "我确认在闪烁",
        "gmtCreate": 1517476347000,
        "productKey": "a1xxxxW",
        "id": 87,
        "dnCopywriting": "接通电源，确认指示灯闪烁",
        "helpIcon": "http://iotx-ilop.oss-cn-hangzhou.aliyuncs.com/iotx-ilop-portal/p/a12xxxxfi/networkConfig/1517476333895/timg (1).jpg",
        "rbacTenantId": "755ED7C7810B4255BA026BBC48BF0247"
    }],
    "id": "e6d8bd5e-b79b-xxxx-xxxx-b3f9c65cdd2b"
}

获取支持配网的产品列表

定义描述

path 版本 描述 是否需要登录
/thing/productInfo/getByAppKey 1.1.5 获取当前支持配网操作的产品列表 是

请求参数

无

返回参数

参数 类型 必有 描述
tenantId String 是 租户ID
productKey String 是 产品的Key
dataFormat Integer 是 设备上传的数据格式，0表示透传或自定义格式；1表示使用Alink协议数据格式
netType Integer 是 产品入网类型：0表示LoRa；3表示WiFi；4表示ZigBee；5表示Bluetooth；6表示蜂窝网；7表示以太网；8表示其他入网方式
nodeType Integer 是 节点类型，0表示设备；1表示网关
name String 是 产品名称
region String 是 产品所在地域
categoryKey String 是 产品所属品类的品类标识符
categoryName String 是 产品所属品类的名称
accessMethod Integer 是 访问方式：0表示数据直连；1表示空中转发；2表示APP
status Integer 是 产品状态，0表示开发中；1表示已发布
gmtCreate Date 是 产品创建时间
gmtModified Date 是 上一次产品信息变更的时间
description String 否 产品描述

示例

  • 请求示例 
    {
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.1.5",
        "iotToken": "token"
    },
    "params": {
    }
}
  • 正常返回示例 
    {
    "id": "94e0871c-0770-xxxx-xxxx-e840d86b3ba6",
    "code": 200,
    "data":[
        {
            "accessMethod": 0,
            "gmtModified": 1515829586000,
            "productKey": "a1oOl0IW16u",
            "dataFormat": 1,
            "netType": 3,
            "nodeType": 0,
            "gmtCreate": 1515829586000,
            "name": "灯",
            "tenantId": "D99AEBxxxxxxxxCF008B2DCE1E313",
            "region": "cn-shanghai",
            "categoryKey":"Light",
            "categoryName":"灯"
            "status": 0
        }
    ]
}