城市数字化管理平台
  1. 开放平台-设备接口
城市数字化管理平台
  • 接入流程
  • 概念说明
  • 开放平台-告警接口
    • 上报告警信息
      POST
  • 开放平台-设备接口
    • 新增或修改摄像头
      POST
    • 新增或修改设备
      POST
    • 新增或修改端口
      POST
    • 新增或修改电力传感器
      POST
    • 删除摄像头
      POST
    • 删除设备
      POST
    • 删除端口
      POST
    • 删除电力传感器
      POST
    • 上报设备实时信息
      POST
    • 上报设备端口实时信息
      POST
  • 开放平台-充电记录接口
    • 新增充电记录
      POST
  • 开放平台-站点接口
    • 新增或修改站点
      POST
    • 删除站点
      POST
  1. 开放平台-设备接口

上报设备实时信息

POST
/govbiz/open/equipment/reportEquipmentInfos
开放平台-设备接口
场景:
实时上报设备电流电量温度信号等信息。
状态变更立即上报,充电中每分钟上报一次,其他时间5-10分钟上报一次

请求参数

Body 参数application/json
array of:
equipmentId
string 
必需
设备编码,运营商内唯一
equipmentStatus
integer <int32>
必需
状态:1正常,2故障
netSignal
number 
可选
网络信号值,精度到小数点后一位
onlineStatus
integer <int32>
必需
在线状态:1上线,2离线
operatorId
string 
运营商编码
必需
current
number 
可选
实时电流,单位A,精度到小数点后一位
voltage
number 
可选
实时电压,单位V,精度到小数点后一位
power
number 
可选
实时功率,单位KW,精度到小数点后一位
temperature
number 
可选
实时温度,精度到小数点后一位
faultCode
string 
可选
故障代码,当状态为故障时候需填写,详细见附表
faultMessage
string 
可选
故障信息,当状态为故障时候需填写
示例
[
    {
        "equipmentId": "string",
        "equipmentStatus": 0,
        "netSignal": 0,
        "onlineStatus": 0,
        "operatorId": "string",
        "current": 0,
        "voltage": 0,
        "power": 0,
        "temperature": 0,
        "faultCode": "string",
        "faultMessage": "string"
    }
]

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/govbiz/open/equipment/reportEquipmentInfos' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "equipmentId": "string",
        "equipmentStatus": 0,
        "netSignal": 0,
        "onlineStatus": 0,
        "operatorId": "string",
        "current": 0,
        "voltage": 0,
        "power": 0,
        "temperature": 0,
        "faultCode": "string",
        "faultMessage": "string"
    }
]'

返回响应

🟢200成功
*/*
OK
Body
code
string 
可选
响应码,000000为成功,其他都为异常
msg
string 
响应消息
可选
示例
{
    "code": "string",
    "msg": "string"
}
🟢201成功
🟠401没有权限
🟠403禁止访问
🟠404记录不存在
修改于 2024-10-31 09:00:15
上一页
删除电力传感器
下一页
上报设备端口实时信息
Built with