上报充电口实时信息

开发中

POST

/platform/report/chargingMetaInfo

充电设施数据上报采用周期上传和变化上传机制，在状态不变的情况下，5-10分钟向平台上报一下状态数据；在状态发生变化时要求立即上报设备状态；在充电过程中时，除了设备状态数据推送外，还需5-10分钟上报一次充电中的数据。

总而言之，要求桩企每间隔5-10分钟，调用此接口一次，上报某一充电口的数据，包括充电口的状态以及电流电压等实时数据

请求参数

Header 参数

Datetime

string

必需

调用接口的时间 yyyy-MM-dd HH:mm:ss

示例值:

2022-02-28 13:45:04

OperatorId

string

运营商 id

必需

示例值:

运营商 id

Token

string

必需

调用 /platform/management/operatorAPIToken 的返回结果

示例值:

平台分发的 token

Signature

string

必需

详见 /platform/management/operatorAPIToken，用户身份签名，对字符串"datetime: yyyy-MM-dd HH:mm:ss\noperatorid: thisisanoperatorid\ntoken: thisisantoken" 的 HMAC 散列的 base64 编码

示例值:

用户身份签名

Body 参数application/json

cellId

string

充电设备接口ID

必需

充电设备接口ID

equipmentId

string

充电设备ID

必需

充电设备ID

operatorId

string

运营商ID

必需

运营商ID

chargingMetaInfoId

string | null

平台生成的id，不用填写，仅在失败回调时需要填写

可选

平台生成的id，不用填写，仅在触发失败回调后再次上报时需要填写

updateDatetime

string

本次数据在充电桩硬件上生成上报的时间

必需

本次数据在充电桩硬件上生成上报的时间，"yyyy-MM-dd HH:mm:ss"

cellStatus

number

充电设备接口状态

必需

0：离网
1：空闲
2：占用（未充电）
3：占用（充电中）
4：占用（预约锁定）
5：占用（充电完成）
255：故障

doorStatus

number

柜门状态

必需

0：未知
10：关闭
50：打开

errorCode

number

故障代码

必需

1000：正常工作；1001：设备未回复电压电流功率
1002：设备未回复错误状态；1003：电表故障
1004：设备故障；1005：欠压告警
1006：过压告警；1007：过流保护
1008：离线告警；1009：漏电流异常告警
1010：输出短路告警；1011：电表异常
1012：无效回应；1013：无效参数
1014：接收超时；1015：过温报警
1016：超过最大功率；1017：设备离线
2001：BID错误；2002：风扇故障
2003：风扇信号故障；2004：电源模块故障
2005：电源模块校准错误；2006：ACC故障
2007：高温报警；2008：烟雾报警
2009：电流波动异常；2010：电流采样故障
2011：电源故障；2012：测试模块失败
2013：测试继电器故障；2014：测试风扇异常
2015：测试开门失败；2016：测试温度异常
2017：异常开门；2018：门锁故障
2019：电池拔出；2020：回应失效
2021：未知类型电池；2022：电池未连接
2023：开门失败；2024：无此订单
2025：充电电压小于电池电压；2026：充电故障
2027：电池电压小于充电电压；2028：电池未连接
2029：恒流阶段电压异常；2030：恒压阶段电流异常
2031：禁止充电时段；2033：订单无效
2034：设备繁忙；2035：初始状态
2036：灭火装置报警

current

number

电流

必需

单位：A，默认：0 含直流(输出), 精确到小数点后一位

voltage

number

电压

必需

单位：V，默认：0含直流(输出) 精确到小数点后一位

power

number

功率

必需

单位：w, 精确到小数点后1位

quantity

number

单次累积电量

必需

默认：0保留小数点后一位

envTemperature

number

实时环境温度

必需

默认：0保留小数点后一位

cirTemperature

number

实时线路温度

必需

默认：0保留小数点后一位

residualCurrent

number

剩余电流

可选

单位：mA默认：0 含直流(输出), 精确到小数点后一位

startChargeSeq

string | null

充电订单号

可选

如果当前充电口处于充电状态，那么可以通过此字段将当前的充电信息关联至某一订单下。不设置此字段，那么平台会自动根据充电口以及账单数据进行匹配，可能导致误差的存在。

receivedByPlatformDatetime

string | null

平台接收到上报数据时间

可选

由平台生成，在回调中返回给用户，yyyy-MM-dd HH:mm:SS

示例

{
    "cellId": "73",
    "equipmentId": "18",
    "operatorId": "81",
    "updateDatetime": "1993-02-01 04:31:50",
    "cellStatus": 15,
    "errorCode": 75,
    "current": 43,
    "voltage": 80,
    "power": 53,
    "quantity": 99,
    "envTemperature": 96,
    "doorStatus": 28,
    "cirTemperature": 79,
    "startChargeSeq": null,
    "receivedByPlatformDatetime": "1972-12-03 12:12:27",
    "chargingMetaInfoId": null
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/platform/report/chargingMetaInfo' \
--header 'Datetime: 2022-02-28 13:45:04' \
--header 'OperatorId: 运营商 id' \
--header 'Token: 平台分发的 token' \
--header 'Signature: 用户身份签名' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cellId": "73",
    "equipmentId": "18",
    "operatorId": "81",
    "updateDatetime": "1993-02-01 04:31:50",
    "cellStatus": 15,
    "errorCode": 75,
    "current": 43,
    "voltage": 80,
    "power": 53,
    "quantity": 99,
    "envTemperature": 96,
    "doorStatus": 28,
    "cirTemperature": 79,
    "startChargeSeq": null,
    "receivedByPlatformDatetime": "1972-12-03 12:12:27",
    "chargingMetaInfoId": null
}'

返回响应

🟢200成功

application/json

Body

status

integer

必需

message

string

必需

data

string

必需

示例

{
    "status": 200,
    "message": "请求成功!",
    "data": "上报成功!"
}

修改于 2022-04-11 04:45:24

（运营商实现该接口）处理请求上报充电过程数据

重新上报充电口实时信息