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

开发中

GET

/example/getChargingMetaInfo

这个接口由运营商实现，并且 url 地址由/platform/management/callbackUrl/getChargingMetaInfo 告知平台，本接口只用来规范接口的数据结构与字段

header 部分与运营商访问平台方式一致，运营商可以通过其中的字段以及 /platform/management/operatorAPIToken 描述的逻辑来检验请求发起者的身份

平台会通过调用该接口主动获取运营商某一充电口某一时刻的充电过程数据，平台会记录调用失败的次数，将来被统计展示出来

请求参数

Query 参数

operatorId

string

运营商id

必需

示例值:

运营商id

cellId

string

充电口id

必需

示例值:

充电口id

updateDatetime

string

必需

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

示例值:

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

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 编码

示例值:

用户身份签名

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/example/getChargingMetaInfo?operatorId=运营商id&cellId=充电口id&updateDatetime=本次数据在充电桩硬件上生成上报的时间' \
--header 'Datetime: 2022-02-28 13:45:04' \
--header 'OperatorId: 运营商 id' \
--header 'Token: 平台分发的 token' \
--header 'Signature: 用户身份签名'

返回响应

🟢200成功

application/json

Body

status

integer

必需

message

string

必需

data

object (ChargingMetaInfo)

必需

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

示例

{
    "status": 20,
    "message": "proident commodo eiusmod aliqua",
    "data": {
        "cellId": "96",
        "equipmentId": "25",
        "operatorId": "74",
        "updateDatetime": "1978-08-07 08:35:59",
        "cellStatus": 100,
        "errorCode": 59,
        "current": 9,
        "voltage": 26,
        "power": 61,
        "quantity": 62,
        "temperature": 96,
        "receivedByPlatformDatetime": null,
        "doorStatus": 57,
        "chargingMetaInfoId": null,
        "startChargeSeq": null
    }
}

修改于 2022-03-22 06:00:36

修改请求上报充电过程数据地址

上报充电口实时信息