中科图灵开放平台 / 智慧消防设备管理模块 / 添加设备

添加设备

接口描述: 添加设备

HTTP/HTTPS
请求协议
POST
请求方式
UTF-8
编码格式
JSON
返回格式
v1.0
版本号

接口参数

参数名字类型是否必须默认值其他说明
access_token字符串可选访问令牌,仅当开启签名验证时需要传递,生成令牌可使用App.Auth.ApplyToken接口
system字符串必须-所属系统 示例
code字符串必须-设备编号 示例
manufacturer整型必须-厂商id 示例
deviceType整型必须-设备类型id 示例
deviceModel整型必须-设备模型id 示例
buildId整型必须-建筑id 示例
floor整型必须-楼层 示例
addressDesc字符串必须-地址描述 示例
model字符串必须-模型 示例
deptId字符串必须-部门id 示例
mark字符串必须-标记的位置 示例
mainEngine字符串必须-主机 示例
address字符串必须-地址 示例
loopBack字符串必须-回路 示例
apiRequestRaw字符串可选-
headerInfo字符串可选-[]

返回字段

返回结果类型说明
ret整型状态码,200表示成功,4xx表示客户端非法请求,5xx表示服务器错误
data对象或混合类型业务数据,由各自接口指定,通常为对象
data.code字符串
data.msg字符串
data.data字符串
msg字符串提示信息,失败时的错误提示

在线测试   

参数是否必须
service 必须
access_token 可选
system 必须
code 必须
manufacturer 必须
deviceType 必须
deviceModel 必须
buildId 必须
floor 必须
addressDesc 必须
model 必须
deptId 必须
mark 必须
mainEngine 必须
address 必须
loopBack 必须
apiRequestRaw 可选
headerInfo 可选

客户端请求示例

成功响应返回示例:
{
    "code": 0,
    "msg": null,
    "data": null
}
失败响应返回示例:

错误列表

错误状态码错误描述信息
400ret=400,客户端参数错误或非法请求
404表示接口服务不存在
406ret=406,access_token令牌校验不通过
407ret=407,app_key权限不足,或未知应用
408ret=408,当前用户禁止使用,或用户未登录
409ret=409,接口流量不足
500表示服务端内部错误

本文档生成时间:2024-02-27 12:56:12