请求方式:POST
URL: http(s)://api.heclouds.com/nbiot
参数名称 | 格式 | 是否必须 | 说明 |
---|---|---|---|
imei | string | 是 | nbiot设备的身份码 |
obj_id | int | 是 | 设备的object id , 对应到平台模型中为数据流id,必填 |
obj_inst_id | int | 是 | nbiot设备object下具体一个instance的id ,对应到平台模型中数据点key值的一部分,必填 |
mode | int | 是 | write的模式,只能是1或者2 |
timeout | int | 否 | 请求超时时间,默认25(单位:秒),取值范围[5,40] |
参数名称 | 格式 | 是否必须 | 说明 |
---|---|---|---|
data | array-json | 是 | 写设备资源的json数组,大小限制2k,见data请求参数描述表 |
参数名称 | 格式 | 是否必须 | 说明 |
---|---|---|---|
res_id | int | 是 | 指定write操作的资源id |
type | int | 否 | 目前支持为1和2: 1代表该资源type为Opaque,此时val字段为该二进制对应的十六进制字符串; 2代表该资源type为Time,此时val字段为时间戳(单位为秒,数值);不写代表该资源type为基础数据类型 |
val | object | 是 | 根据指定资源的类型决定val的数值类型,可为boolean、string、long、double |
参数名称 | 格式 | 说明 |
---|---|---|
errno | int | 调用错误码,为0表示调用成功 |
error | string | 错误描述,为"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 表示错误原因。