OneNET物联网平台 平台介绍
平台简介 平台架构 资源模型 术语解释
入门手册
账户与登录 产品与设备
创建产品 接入协议简介 创建设备
创建单个设备 批量创建设备
导出设备
数据流与数据点 应用管理
服务介绍 控件介绍 操作说明
规则引擎
服务介绍 控制台配置 基础数据 SQL语句
消息队列 HTTP推送 安全鉴权
设备开发指南
协议文档 SDK 调试工具 设备云APP下载 多协议接入
LwM2M
协议介绍 接入说明 已支持的模组列表 NB常见问题 接入实例（M5310） 接入实例（MCU）
MQTT
协议介绍 接入说明
EDP
协议介绍 接入说明
Modbus
协议介绍 接入说明
TCP
协议介绍 接入说明
OTA升级
OTA使用说明 OTA-API使用实例 南向API
检测升级任务 chek接口 获取资源接口 上报升级状态
OTA-SDK使用说明
应用开发指南
API
API使用 API列表 SDK MQTT
新增设备 注册设备 更新设备 查询设备详情 批量查询设备详情 批量查询设备状态 删除设备 新增数据流 更新数据流 查询数据流 批量查询数据流 删除数据流 查询设备历史数据 批量查询设备数据 上传数据点 上传文件 获取文件 发送命令 查询命令状态 查询命令响应 查询设备历史命令 新增触发器 更新触发器 查询触发器 删除触发器 新增apikey 更新apikey 查询apikey 删除apikey 发布消息 查询订阅topic设备 查询设备订阅topic 查询产品topic
LwM2M
API返回状态码 创建设备 查询单个设备 删除设备 获取资源列表 订阅 即时命令-读设备资源 缓存命令-读设备资源 即时命令-写设备资源 缓存命令-写设备资源 即时命令-命令下发 缓存命令-命令下发 查看设备缓存命令列表 查看指定缓存命令详情 取消缓存命令 新增触发器 更新触发器 查看触发器 删除触发器 批量查询设备状态 批量查询设备数据 查看数据点 根据imei查询设备信息 查看设备bs_psk 更新bs_psk 新增acc_psk 编辑acc_psk 查看设备acc_psk
EDP
新增设备 注册设备 更新设备 查询设备详情 批量查询设备详情 批量查询设备状态 删除设备 新增数据流 更新数据流 查询数据流 批量查询数据流 删除数据流 查询设备历史数据 批量查询设备数据 上传数据点 上传文件 获取文件 发送命令 查询命令状态 查询命令响应 查询设备历史命令 新增触发器 更新触发器 查询触发器 删除触发器 新增apikey 更新apikey 查询apikey 删除apikey
Modbus
新增设备 更新设备 查询设备详情 批量查询设备详情 批量查询设备状态 删除设备 新增数据流 更新数据流 查询数据流 批量查询数据流 删除数据流 查询设备历史数据 批量查询设备数据 上传数据点 发送命令 查询命令状态 查询命令响应 查询设备历史命令 新增触发器 更新触发器 查询触发器 删除触发器 新增apikey 更新apikey 查询apikey 删除apikey
TCP
新增设备 注册设备 更新设备 查询设备详情 批量查询设备详情 批量查询设备状态 删除设备 新增数据流 更新数据流 查询数据流 批量查询数据流 删除数据流 查询设备历史数据 批量查询设备数据 上传数据点 上传文件 获取文件 发送命令 查询设备历史命令 新增触发器 更新触发器 查询触发器 删除触发器 新增apikey 更新apikey 查询apikey 删除apikey
消息队列MQ
服务概述 开发指南 正则表达式筛选规则 demo工程 最佳实例 使用限制
HTTP推送
服务概述 开发指南 SDK
常见问题
平台地址列表 技术类 商务类 OCP类 开发板申请类 开发板技术类
发布公告
2019-01 2019-02 2019-03 2019-07

即时命令-写设备资源

请求方式：POST

URL: http://API_ADDRESS/nbiot

url参数

参数名称 格式 是否必须 说明
imei string 是 nbiot设备的身份码
obj_id int 是 设备的object id，根据终端设备sdk确定
obj_inst_id int 是 nbiot设备object下具体的一个实例id,根据终端设备sdk确定
mode int 是 write的模式，只能是1或者2
timeout int 否 请求超时时间，默认25(单位：秒)，取值范围[5, 40]

http请求参数

参数名称 格式 是否必须 说明
data array-json 是 写设备资源的json数组，大小限制2k，见data请求参数描述表
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状态码所对应的含义，可以在OneNET文档中心->设备开发指南->协议文档->LWM2M中《NB协议北向api返回状态码说明》下载查看

mode取值： 1 ，表示replace ，意为替换指定的instance或者resource的值 ; 2，表示partial update , 意为只更新给定的resource或者resource instace的值

请求示例

POST http://API_ADDRESS/nbiot HTTP/1.1
api-key: WhI*************v1c=
Content-Type: application/json
Host: API_ADDRESS

请求参数示例

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

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

返回示例

{
    "errno": 0,
    "error": "succ"
}

个搜索结果，搜索内容 “”

    0 个搜索结果，搜索内容 “”

    意见反馈
    智能客服
    加入我们
    立即注册