• 快速入门
  • HTTP文档
  • .NET开发指南
  • DEMO下载
  • 调用HTTP常见问题
    Show / Hide Table of Contents
    • 登录接口
      • 名词解释
      • 用户登录
      • 重新登录
    • 写值流程
      • 新增FBox分组
      • FBox新增
      • 新增监控点分组
      • 新增数据监控点
      • FBox列表获取
      • FBox监控点列表
      • 监控点值写入
      • 获取监控点值
    • 获取信息接口
      • 获取单个盒子
      • 获取监控点分组
      • 获取某些监控点
      • 根据监控点分组获取监控点
      • 获取物联网卡Iccid、Imei
      • 获取盒子地理位置
    • 远程下载
      • 获取FBox驱动列表
      • 下载盒子驱动
      • 获取连接设备的寄存器类型
      • 获取服务器驱动列表
    • 盒子修改接口
      • 修改FBox分组
      • FBox名称修改
      • 修改数据监控点
      • 修改省流量模式刷新间隔
    • 盒子删除接口
      • 删除FBox分组
      • FBox删除
      • 删除监控点分组
      • 删除数据监控点
    • 报警接口
      • 报警分组接口
        • 获取报警分组列表
        • 新增报警分组
        • 修改报警分组
        • 删除报警分组
      • 报警联系人接口
        • 获取报警联系人列表
        • 获取单个报警联系人
        • 新增报警联系人
        • 修改报警联系人
        • 删除报警联系人
      • 报警记录接口
        • 获取报警条目列表
        • 获取某些报警条目
        • 新增报警条目
        • 修改报警条目
        • 删除报警条目
        • 获取报警历史
        • 获取报警条目状态
        • 确认报警
    • 历史记录接口
      • 获取历史记录条目
      • 获取某些历史记录条目
      • 新增历史记录
      • 更新历史记录
      • 删除历史记录
      • 获取历史记录数据
    • 监控点推送控制接口
      • 开启某监控点组别
      • 停止某监控点组别
      • 开启监控点组别列表
      • 停止监控点组别列表
      • 开启FBox所有监控点
      • 停止FBox所有监控点
      • 开启某条监控点
      • 停止某条监控点
      • 开启某些监控点
      • 停止某些监控点
      • 只开启某些监控点
      • 只开启某监控点组
      • 只开启某些监控点组
    • 数据推送(SignalR)
      • 实时数据推送(signalR)
      • FBox状态变更推送
      • 实时数据推送
      • 报警触发推送
      • 报警还原推送
    • 统一写值
      • 获取所有统一写分组
      • 统一写分组值写入
    • 附录
      • 附录一
      • 附录二
      • 附录三
      • 429状态码

    FBox监控点列表

    • 功能描述

      该接口用于用户获取当前FBox下所有监控组的数组(JSON数组)

    • 请求地址:(二选一)

      旧版:

      URL1:[apiBaseUrl]v2/box/{boxId}/dmon/grouped

      URL2:[apiBaseUrl]v2/box/dmon/grouped?boxNo={boxNo}

      新版:

      URL1:[Host Server]/api/v2/box/{boxId}/dmon/grouped

      URL2:[Host Server]/api/v2/box/dmon/grouped?boxNo={boxNo}


    • 地址参数说明

      字段名 类型 描述
      apiBaseUrl string 详情见名词解释
      Uid Long FBox列表获取接口中boxRegs下box下id
      boxNo string FBox的序列号
    • 请求方式

      GET

    • Headers

      字段名 类型 描述
      Authorization string Bearer+ 空格+登录接口中获得的access_token
    • Body

      NULL

    • 响应成功

      字段名 类型 描述
      id string 监控点分组Id
      name string 监控点分组名称
      items json数组 监控点条目数组,单个属性见下表

      监控点条目属性如下:

      字段名 类型 描述
      id string 监控点Id
      name string 监控点名称
      grpId string 监控点分组id
      grpName string 监控点分组名称
      devAlias string 设备驱动别名
      station int PLC通讯站号
      dataType int 数据类型,详情见附录二
      regId int 寄存器Id,与ioWidth联合使用,确定唯一寄存器
      ioWidth int 寄存器位宽,与regId联合使用,确定唯一寄存器
      regName string 寄存器名称,能确定唯一寄存器,与上面两参数任选其一
      addr int PLC主地址
      subAddr int PLC子地址
      addrBlk int PLCDB块地址
      intDigits int 整数位(目前无效),对位类型、二进制、十六进制、字符串类型无效
      fracDigits int 小数位
      unit string 单位,仅对字类型有效
      privilege int 读写模式2:只写模式,4:只读模式,6:读写模式
      trafficSaving boolean 是否省流量模式,true:启用,false:不启用
      deadValue float 死区值,数据再±deadValue范围内数据不推送
      label json对象 位类型时显示标签,属性ttext:值为1时显示的文本,ftext:值为0时显示的文本
      memo string 备注信息
      encoding int 编码格式,字符串类型使用0:无,非字符串类型使用,1:Unicode,2:Ascii
      stringByteOrder int 字符串字节序,编码为Ascii格式时有效0:倒序,1:正序
      charCount int 字符粗个数(仅字符串类型有效)
      deviceChanged boolean 设备是否被移除(只有在移除时出现该参数,为true)FBox的连接设备変更后会出现该参数
      tstate int 离线任务标记,0:未执行,1:执行成功,2:执行失败,3:固件不支持
      valueTransform jobject 数值运算设置
      executeOnEdge boolean 是否启用边缘执行,启用时必须配置数值运算

      数值运算设置详细表

      字段名 类型 描述
      maxValue int 数值上限
      minValue int 数值下限
      scaleMaxValue int 比例上限
      scaleMinValue int 比例下限
      gain int 增益
      offset int 偏移量
      type int 1:比例转换,2:缩放
    • 返回码

      字段名 描述
      200 执行成功
      401 accessToken过期
      404 接口不存在,请检查URL
      429 访问接口频率过快,详情见429状态码
      400 错误信息在HTTP Header里[X-FBox-Code],详细见附录三
    • 调用案例如下图

    监控点列表接口

    Back to top Generated by DocFX