OneNET Studio 简介 产品介绍 快速入门 设备接入与管理 应用开发
应用开发流程 新建项目 添加设备 设备分组 场景联动 应用数据流转 应用API 应用长连接 规则引擎(新)
运维监控 数据可视化 边缘计算 人工智能AI 位置定位 语音通话 工业互联网标识 权限管理 服务协议 更新日志

设备服务调用

1. 设备服务调用


1. 设备服务调用

物联网平台支持同步调用和异步调用,同步调用超时时间5s,异步调用无超时时间

下行(OneJSON)

  • 请求topic: $sys/{pid}/{device-name}/thing/service/{identifier}/invoke

OneJSON数据格式:

{
    "id":"123",
    "version":"1.0",
    "params":{
        "Power1":"on",
        "WF1":"2"
    }
}

表:请求参数描述

参数 类型 描述
identifier String 功能点唯一标识符(产品下唯一)
id String 消息id号,用户自定义,String类型的数字,长度限制不超过13位。
version String 物模型版本号,可选字段,不填默认为1.0
params Object 服务的请求参数,参数类型具体见物模型对应的“服务”定义(输入参数部分)
{
"Power1":"on",
"WF1":"2"
}
  • 响应topic: $sys/{pid}/{device-name}/thing/service/{identifier}/invoke_reply

OneJSON数据格式:

{
    "id":"123",
    "code":200,
    "msg":"xxxx",
    "data":{
        "result1":"on",
        "result2":"2"
    }
}

表:响应参数描述

参数 类型 描述
id String 消息id号,用户自定义,String类型的数字,长度限制不超过13位。
code Integer 结果状态码
msg String 错误消息
data Object 服务的响应参数,参数类型具体见物模型对应的“服务”定义(输出参数部分)
{
"result1":"on",
"result2":"2"
}

说明:

  • 同步调用,返回以上结果;
  • 异步调用,平台收到服务调用请求后立即返回以上结果给应用,但是不包含data字段;平台收到设备响应后,按以上结果(含data字段)将数据通过规则引擎流转MQ、推送或数据存储,用户通过MQ、HTTP推送等服务获取设备服务执行结果,也可通过「设备详情」-「服务记录」查看相关执行结果,亦可通过api查询获取执行结果。

个搜索结果,搜索内容 “

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