平台接口
  1. 设备管理
平台接口
  • 根目录
    • 认证
      • 用户登录
      • 退出登录
      • 刷新token
      • 获取当前登录用户信息
      • 修改当前用户密码
      • 获取设备登录二维码
    • 用户
      • 获取根用户组信息
      • 获取用户组信息
      • 获取用户组列表
      • 获取用户列表
      • 获取在线用户列表
      • 获取用户在线状态
      • 获取用户当前定位
      • 获取用户信息
    • 角色
      • 获取角色列表
      • 获取角色信息
      • 创建角色
      • 修改角色
      • 删除角色
      • 获取角色资源列表
      • 添加角色资源
      • 删除角色资源
    • 用户管理
      • 创建用户组
      • 修改用户组
      • 删除用户组
      • 获取用户信息要求
      • 检查创建用户信息是否可用
      • 创建用户
      • 修改用户
      • 删除用户
      • 修改用户密码
      • 踢用户下线
      • 获取用户资源列表
      • 添加用户资源
      • 删除用户资源
    • 设备
      • 获取根设备组信息
      • 获取设备组列表
      • 获取设备组信息
      • 获取设备分类列表
      • 获取设备分类信息
      • 获取设备列表
      • 获取设备信息
      • 获取设备在线状态
      • 获取设备当前定位
      • 获取电池信息
      • 透传命令
      • 手动录像-开始
      • 手动录像-停止
      • 手动抓拍一张图片
    • 设备管理
      • 创建设备组
        POST
      • 修改设备组
        PUT
      • 删除设备组
        DELETE
      • 添加设备
        POST
      • 删除设备
        DELETE
      • 重启设备
        POST
      • 关闭设备
        POST
      • 创建设备分类
        POST
      • 修改设备分类
        PUT
      • 删除设备分类
        DELETE
      • 获取未分组设备信息
        GET
      • 修改设备基本信息
        PUT
      • 批量修改设备所属组
        PUT
      • 批量修改设备所属分类
        PUT
      • 修改设备通道信息
        PUT
      • 踢在线设备下线
        POST
      • 获取通用配置
        GET
      • 设置通用配置
        PUT
      • 设置电源配置
        PUT
      • 获取以太网配置
        GET
      • 设置以太网配置
        PUT
      • 获取Wifi配置
        GET
      • 设置Wifi配置
        PUT
      • 获取无线网络配置
        GET
      • 设置无线网络配置
        PUT
      • 获取抓拍配置
        GET
      • 设置抓拍配置
        PUT
      • 获取音频输入配置
        GET
      • 设置音频输入配置
        PUT
      • 获取音频输出配置
        GET
      • 设置音频输出配置
        PUT
      • 获取设备编码通道属性
        GET
      • 设置设备编码通道属性
        POST
      • 获取视频源
        GET
      • 设置视频源
        PUT
      • 获取设备GPS配置
        GET
      • 设置设备GPS配置
        POST
      • 获取设备服务器配置
        GET
      • 设置设备服务器配置
        POST
      • 获取设备存储器信息
        GET
      • 设置设备存储器信息
        PUT
      • 获取格式化进度
        GET
      • 格式化存储器
        PUT
      • 获取设备存储设置
        GET
      • 修改设备存储设置
        POST
      • 获取设备上传设置
        GET
      • 修改设备上传设置
        POST
      • 获取存储状态
        GET
      • 获取存储计划
        GET
      • 设置存储计划
        PUT
      • 获取叠加信息
        GET
      • 设置叠加信息
        PUT
      • 获取升级固件状态
        GET
      • 批量获取升级固件状态
        POST
      • 升级固件
        POST
      • 获取执法仪信息
        GET
      • 设置执法仪信息
        PUT
      • 获取传感器数据
        GET
      • 设置传感器数据
        PUT
      • 获取上下线控制配置
        GET
      • 设置上下线控制配置
        PUT
      • 添加配置计划
        POST
      • 修改配置计划
        PUT
      • 删除配置计划
        DELETE
      • 获取配置计划
        GET
      • 获取配置计划列表
        POST
      • 添加配置计划设备
        POST
      • 删除配置计划设备
        POST
      • 获取配置计划设备列表
        POST
      • 获取配置计划设备
        GET
      • 获取配置计划未关联设备列表
        POST
    • 云台
      • 云台镜头控制
      • 获取云台预置点列表
      • 添加云台预置点
      • 修改云台预置点
      • 删除云台预置点操作
      • 转到云台预置点
      • 获取云台巡航路线列表
      • 添加云台巡航路线
      • 启动云台巡航路线
      • 停止云台巡航路线
      • 删除云台巡航路线
    • IM群组
      • 获取群组列表
      • 获取群组成员列表
      • 获取群成员信息
      • 获取群组信息
      • 创建群组
      • 修改群组
      • 删除群组
      • 添加群成员
      • 删除群成员
      • 修改其它群成员
      • 修改自己群昵称
      • 转让群组
      • 创建会议
      • 修改会议
      • 删除会议
      • 获取会议信息
      • 获取会议成员列表
      • 获取会议成员信息
      • 获取默认会议成员列表
      • 自己加入会议
      • 自己退出会议
      • 申请发言
      • 结束发言
      • 邀请他人加入会议
      • 将他人踢出会议
      • 点名他人发言
      • 获取默认会议
      • 添加默认会议
      • 删除默认会议
      • 会议录音控制
      • 禁言控制
    • 即时通讯
      • 发送通讯消息
      • 确认消息已读
      • 查询本人聊天记录
      • 聊天记录高级查询
      • 查询已读消息ID
      • 请求音视频通话
    • websocket
      • 在线状态订阅
      • 报警事件订阅
      • 即时通讯订阅
      • 设备位置订阅
      • 会议事件订阅
      • 命令交互订阅
      • 第三方平台消息推送
    • 历史数据
      • 平台文件检索
      • 获取录像文件信息
      • 修改录像文件信息
      • 处理报警
      • 报警记录
      • 设备GPS轨迹
      • 设备文件检索
      • 下载设备文件
      • 删除设备文件
      • 设备上下线日志
      • 用户上下线日志
      • 设备上下线日志(extend)
      • 用户上下线日志(extend)
      • 操作日志
      • 通道日志
      • 系统告警记录
      • 创建统计任务
      • 获取统计结果
      • 删除统计任务
      • 通道日志统计
    • 电子围栏
      • 获取围栏列表
      • 获取围栏信息
      • 创建平台围栏
      • 修改平台围栏
      • 删除平台围栏
      • 获取围栏设备列表
      • 添加围栏设备
      • 删除围栏设备
    • 报警联动
      • 添加报警联动
      • 修改报警联动
      • 获取报警联动列表
      • 获取报警联动
      • 删除报警联动
      • 添加报警联动对象列表
      • 删除报警联动作用对象
      • 获取报警联动对象列表
      • 添加报警联动动作
      • 删除报警联动动作
      • 获取报警联动动作列表
      • 获取报警联动动作
    • 28181in
      • 获取28181设备列表
      • 获取28181设备信息
      • 添加28181设备
      • 修改28181设备
      • 删除28181设备
      • 获取28181平台列表
      • 获取28181平台信息
      • 添加28181平台
      • 修改28181平台
      • 删除28181平台
      • 获取28181平台分组列表
      • 获取配置信息
      • 创建录像文件下载任务
      • 获取录像文件列表
      • 获取录像文件下载进度
      • 录像文件下载
      • 更新通道信息
    • 28181out
      • 添加上级平台
      • 获取上级平台信息
      • 修改上级平台
      • 删除上级平台
      • 获取上级平台列表
      • 推送目录
      • 获取状态
      • 获取设备分组列表
      • 添加设备分组
      • 修改设备分组
      • 删除设备分组
      • 获取设备分组
      • 获取28181设备列表
      • 添加28181设备
      • 修改28181设备
      • 删除28181设备
      • 基于puid获取28181设备信息
      • 基于国标id获取28181设备信息
      • 添加通道信息
      • 修改通道信息
      • 删除通道信息
      • 获取通道信息
      • 获取28181通道列表
      • 添加上级平台设备
      • 删除上级平台设备
      • 获取上级平台设备列表
    • 地图标签
      • 创建地图点标签
      • 修改地图点标签
      • 查询地图点标签列表
      • 查询地图点标签信息
      • 创建地图线标签
      • 修改地图线标签
      • 查询地图线标签列表
      • 查询地图线标签信息
      • 创建地图面标签
      • 修改地图面标签
      • 查询地图面标签列表
      • 查询地图面标签信息
      • 添加地图标签定位点
      • 修改地图标签定位点
      • 删除地图标签定位点
      • 删除地图标签
      • 查询地图标签定位点列表
      • 查询地图标签定位点信息
    • 录像文件时间线
      • 添加
      • 删除
      • 查询
    • 平台存储
      • 下载计划--添加
      • 下载计划--获取
      • 下载计划--修改
      • 下载计划--查询
      • 下载计划--删除
      • 录像计划--添加
      • 录像计划--获取
      • 录像计划--修改
      • 录像计划--查询
      • 录像计划--删除
      • 计划设备关联--添加
      • 计划设备关联--修改
      • 计划设备关联--删除
      • 计划设备关联--查询
      • 计划设备关联--查询未关联
      • 手动录像--开始
      • 手动录像--结束
      • 手动抓拍一张图片
    • 平台存储状态
      • 下载计划列表
      • 下载计划关联设备列表
      • 正在下载列表
      • 设备文件列表
      • 重试/优先下载
      • 重新下载(已下载的文件)
      • 会话列表
      • 关闭会话
      • 录像计划日志-设备
      • 录像计划日志-录像计划
    • 联系人
      • 取消置顶
      • 添加置顶
      • 获取置顶列表
    • 模块程序
      • cs app 查询
      • cs app 批量修改
      • cs app 修改
      • webapp 查询
      • webapp 获取主页
      • webapp 设置主页
      • webapp 获取配置
      • webapp 设置配置
      • plugapp 查询
      • module 查询
    • 黑白名单
      • 获取黑白名单配置
      • 修改黑白名单配置
      • 获取黑白名单
      • 删除黑白名单
      • 添加黑白名单
    • 媒体流操作
      • 关闭会话
      • 打开设备音视频流webrtc
      • 打开设备音视频流bvrtc
      • 打开语音会议流webrtc
      • 打开语音会议流bvrtc
      • 打开语音会议流websocket
      • 打开回放音视频流
      • 回放控制
      • 查阅会话列表
      • 获取会话信息
      • 查阅流媒体服务列表
      • 重置流媒体服务统计
    • 采集站管理
      • 录入采集站
      • 获取采集站列表
      • 获取采集站信息
      • 修改采集站信息
      • 删除采集站信息
      • 踢采集站下线
    • 采集站对接
      • 采集站上线
      • 采集站下线
      • 采集站保活
      • 上报文件索引
      • 获取文件信息
      • 删除文件
    • 平台文件分类
      • 获取文件分类列表
      • 获取文件分类信息
      • 创建文件分类
      • 修改文件分类
      • 删除文件分类
      • 文件绑定分类
  1. 设备管理

添加设备

POST
https://192.168.88.30:9781/bvcsp/v1/pu/add
最后修改时间:2025-01-08 08:15:19

请求参数

Header 参数
Content-Type
string 
必需
示例值:
application/json
Authorization
string 
必需
login返回的token
Body 参数application/json
设备信息
id
string 
设备ID
必需
gid
string 
所属组ID
必需
name
string 
设备名称
必需
manufacturer
string 
制造商名字
可选
product
string 
产品名
可选
softwareVersion
string 
软件版本
可选
hardwareVersion
string 
硬件版本
可选
classID
integer 
设备分类
可选
gps
object 
上报或设置的位置
可选
lng
number 
必需
经度(WGS84),单位:度
lat
number 
必需
维度(WGS84),单位:度
time
integer 
必需
hardware
object 
硬件信息
可选
WIFI
integer 
WIFI数目
可选
radio
integer 
无线模块数目
可选
videoIn
integer 
视频输入数
可选
audioIn
integer 
音频输入数
可选
audioOut
integer 
音频输出数
可选
PTZ
integer 
PTZ数
可选
serialPort
integer 
串口数
可选
alertIn
integer 
报警输入数
可选
alertOut
integer 
报警输出数
可选
storage
integer 
存储设备数
可选
GPS
integer 
GPS设备数
可选
示例
{
  "id": "string",
  "gid": "string",
  "name": "string",
  "manufacturer": "string",
  "product": "string",
  "softwareVersion": "string",
  "hardwareVersion": "string",
  "classID": 0,
  "gps": {
    "lng": 0,
    "lat": 0,
    "time": 0
  },
  "hardware": {
    "WIFI": 0,
    "radio": 0,
    "videoIn": 0,
    "audioIn": 0,
    "audioOut": 0,
    "PTZ": 0,
    "serialPort": 0,
    "alertIn": 0,
    "alertOut": 0,
    "storage": 0,
    "GPS": 0
  }
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://192.168.88.30:9781/bvcsp/v1/pu/add' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": "string",
    "gid": "string",
    "name": "string",
    "manufacturer": "string",
    "product": "string",
    "softwareVersion": "string",
    "hardwareVersion": "string",
    "classID": 0,
    "gps": {
        "lng": 0,
        "lat": 0,
        "time": 0
    },
    "hardware": {
        "WIFI": 0,
        "radio": 0,
        "videoIn": 0,
        "audioIn": 0,
        "audioOut": 0,
        "PTZ": 0,
        "serialPort": 0,
        "alertIn": 0,
        "alertOut": 0,
        "storage": 0,
        "GPS": 0
    }
}'

返回响应

🟢200成功
application/json
Body
code
enum<integer> 
结果码
必需
枚举值:
012357468916101112131415171819
msg
string 
结果描述
必需
示例
{
  "code": 0,
  "msg": "string"
}
上一页
删除设备组
下一页
删除设备
Built with