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

缓存命令-写设备资源/Write

请求方式:POST

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

我只想看示例!!!

url参数

参数名称格式是否必须说明
imeistring nbiot设备的身份码,必填
obj_idint设备的object id , 对应到平台模型中为数据流id,必填
obj_inst_idintnbiot设备object下具体一个instance的id ,对应到平台模型中数据点key值的一部分,必填
modeintwrite的写模式,只能是1或者2
valid_timestring命命令开始生效时间,可选(不填时默认为OneNET当前时间),填写必须大于OneNET服务器的当前时间
expired_timestring命令过期时间戳,必填且大于valid_time
retryint[0-10]之间,表示失败重试次数(等待下一次设备update或者上线),可选(不填时默认为3),填写时必须在[0, 10]之间
timeoutint过期时间,填写时必须在[5,40]s之间;不填写默认为25s
trigger_msgint命令触发的上行消息类型,填写时必须在[1,7]之间;不填写默认为7

http请求参数

参数名称格式是否必须说明
dataarray-json写设备资源的json数组,大小限制2k,见data请求参数描述表

data请求参数描述表

参数名称格式是否必须说明
res_idintnbiot设备的资源id
typeint目前支持为1和2,1代表该资源type为Opaque,此时val字段为该二进制对应的十六进制字符串;2代表该资源type为Time,此时val字段为时间戳(单位为秒,数值);不写代表该资源type为基础数据类型
valobject值,可为boolean、string、long、double

返回参数

参数名称格式说明
errnoint调用错误码,为0表示调用成功
error string错误描述,为"succ"表示调用成功
datajson接口调用成功之后返回的设备相关信息,见data描述表

data描述表

参数名称格式说明
uuidstring 缓存命令uuid
说明

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

trigger_msg 触发类型:
1. REGISTER   
2. UPDATE   
3. REGISTER | UPDATE 组合  
4. NOTIFY
5. REGISTER | NOTIFY 组合
6. UPDATE | NOTIFY 组合
7. NOTIFY | UPDATE | REGISTER 组合

请求示例

POST http://api.heclouds.com/nbiot/offline?imei=86582003***&valid_time=2016-08-05T08:00:00&expired_time=2016-08-06T08:00:00&obj_id=1212&obj_inst_id=1212&mode=1 HTTP/1.1
api-key: WhI*************v1c=  //必须为 MasterKey, 由于涉及个人隐私, 这里用“*******” 代替
Content-Type: application/json

请求参数示例

非opaque类型:
{
    "data":[
        {
            "res_id":12,
            "val":121
        }
    ]
}

opaque类型:
{
    "data":[
        {
            "res_id":12,
            "type":1,
            "val":"121A"
        }
    ]
}

返回示例

{
    "errno": 0,
    "error":"succ",
    "data":
        {
         "uuid":"42742677-adc3-54ca-83a1-5aaaf71482f8"//缓存命令uuid
        }
} //响应消息中 errno 表示错误码, error 表示错误原因。

< 缓存命令-读设备资源

缓存命令-命令下发 >

个搜索结果,搜索内容 “

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