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

根据设备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
            }
        ]
    }