NB-IoT物联网套件 产品介绍 快速入门 用户指南 设备开发指南 应用开发指南 NB设备远程升级 最佳实践 常见问题 服务协议 更新日志 接入地址列表

即时命令-写设备资源

请求方式:POST

URL: http(s)://api.heclouds.com/nbiot

我只想看示例!!!

url参数

参数名称格式是否必须说明
imeistringnbiot设备的身份码
obj_idint设备的object id , 对应到平台模型中为数据流id,必填
obj_inst_idintnbiot设备object下具体一个instance的id ,对应到平台模型中数据点key值的一部分,必填
modeintwrite的模式,只能是1或者2
timeoutint请求超时时间,默认25(单位:秒),取值范围[5,40]

http请求参数

参数名称格式是否必须说明
dataarray-json写设备资源的json数组,大小限制2k,见data请求参数描述表
data描述表
参数名称格式是否必须说明
res_idint指定write操作的资源id
typeint目前支持为1和2:
1代表该资源type为Opaque,此时val字段为该二进制对应的十六进制字符串;
2代表该资源type为Time,此时val字段为时间戳(单位为秒,数值);不写代表该资源type为基础数据类型
valobject根据指定资源的类型决定val的数值类型,可为boolean、string、long、double

返回参数

参数名称格式说明
errnoint调用错误码,为0表示调用成功
errorstring错误描述,为"succ"表示调用成功
说明

返回errno状态码所对应的含义,可以查看API状态码

1、mode取值:

(1)表示replace ,意为替换指定的instance或者resource的值 ;

(2)表示partial update , 意为只更新给定的resource或者resource instace的值。

2、HTTP内容部分必须存在。

3、type字段可选,目前支持1和2,1代表该资源type为Opaque,此时val字段为该二进制对应的十六进制字符串;2代表该资源type为Time,此时val字段为时间戳(单位为秒,数值)

请求示例

POST http://api.heclouds.com/nbiot HTTP/1.1
api-key: WhI*************v1c= //必须为 MasterKey, 由于涉及个人隐私, 这里用“*******” 代替
Content-Type: application/json
Authorization: version=2018-10-31&res=products/23104&et=1554398783&method=sha1&sign=fsBwuj0udOpU3BLoHmpbFwyIo30=

请求参数示例

非opaque类型:
{
    "data":[
        {
            "res_id":12,
            "val":121
        }
    ]
} //HTTP内容部分必须存在。

opaque类型:
{
    "data":[
        {
            "res_id":12,
            "type":1,
            "val":121
        }
    ]
} //HTTP内容部分必须存在。

返回示例

{
    "errno": 0,
    "error": "succ"
} //响应消息中 errno 表示错误码, error 表示错误原因。

< 即时命令-读设备资源

即时命令-命令下发 >

个搜索结果,搜索内容 “

    0 个搜索结果,搜索内容 “