提交充电记录信息列表

开发中

POST

/platform/management/chargingRecordList

http-api/platform/运营数据管理/充电记录管理

提交充电信息列表, 一次最多 30 个

请求参数

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

array of:

startChargeSeq

string

充电订单号

必需

格式“运营商ID+yyyyMMddHHmmss+4位随机数”，27字符

cellId

string

充电设备接口id

必需

充电设备接口id

operatorId

string

运营商id

必需

运营商id

startDatetime

string

开始充电时间

必需

格式“yyyy-MM-dd HH:mm:ss”

endDatetime

string

结束充电时间

必需

格式“yyyy-MM-dd HH:mm:ss”

totalPower

number

累计充电量

必需

单位：度，小数点后2位

totalElecMoney

number

总电费

必需

单位：元，小数点后2位

totalServiceMoney

number

总服务费

必需

单位：元，小数点后2位

startType

integer

启动方式

必需

stopReason

integer

结束原因

必需

0 按照充电服务类型正常停止充电。
1 用户本地刷卡停止充电。
2 用户远程结束充电。
3 平台远程结束充电
4 检测到枪头断开而停止充电
5 检测到充电桩掉电而停止充电。
6 检测到充电桩故障而停止充电。
7 检测到电动车故障而停止充电。
8 其它原因停止充电。
9 检测到充满停止充电。
10 检测到余额不足而停止充电。
11 过载停止
12 过压停止
13 欠压停止
14 整桩实时功率过大停止充电
15 手机蓝牙停止
16 设备接地故障
17 设备温度过高
18 未关闭柜门
19 电池温度异常
20 电池电压异常
21 电池温差超过阈值
22 电池压差超过阈值
23 功率异常浮动停止充电
24 超时结束充电（电量充电时超时（720分钟））

averagePower

number

平均功率

必需

补平均功率[默认0] 单位：0.01W, 精确到小数点后1位

示例

[
    {
        "startChargeSeq": "startChargeSeq013",
        "cellId": "testcellid001",
        "operatorId": "sika01",
        "startDatetime": "1980-03-17 01:58:42",
        "endDatetime": "2007-08-30 17:26:32",
        "totalPower": 57.1,
        "totalElecMoney": 90.1,
        "totalServiceMoney": 85.3,
        "startType": 1,
        "stopReason": 1,
        "averagePower": 35.2
    },
    {
        "startChargeSeq": "startChargeSeq014",
        "cellId": "testcellid001",
        "operatorId": "sika01",
        "startDatetime": "1980-03-17 01:58:42",
        "endDatetime": "2007-08-30 17:26:32",
        "totalPower": 57.1,
        "totalElecMoney": 90.1,
        "totalServiceMoney": 85.3,
        "startType": 1,
        "stopReason": 1,
        "averagePower": 35.2
    }
]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/platform/management/chargingRecordList' \
--header 'Datetime: 2022-02-28 13:45:04' \
--header 'OperatorId: 运营商 id' \
--header 'Token: 平台分发的 token' \
--header 'Signature: 用户身份签名' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "startChargeSeq": "startChargeSeq013",
        "cellId": "testcellid001",
        "operatorId": "sika01",
        "startDatetime": "1980-03-17 01:58:42",
        "endDatetime": "2007-08-30 17:26:32",
        "totalPower": 57.1,
        "totalElecMoney": 90.1,
        "totalServiceMoney": 85.3,
        "startType": 1,
        "stopReason": 1,
        "averagePower": 35.2
    },
    {
        "startChargeSeq": "startChargeSeq014",
        "cellId": "testcellid001",
        "operatorId": "sika01",
        "startDatetime": "1980-03-17 01:58:42",
        "endDatetime": "2007-08-30 17:26:32",
        "totalPower": 57.1,
        "totalElecMoney": 90.1,
        "totalServiceMoney": 85.3,
        "startType": 1,
        "stopReason": 1,
        "averagePower": 35.2
    }
]'

返回响应

🟢200成功

application/json

Body

status

integer

必需

message

string

必需

data

string

必需

示例

{
    "status": 200,
    "message": "请求成功!",
    "data": "提交成功"
}

修改于 2022-05-28 08:37:10

分页查询多个充电记录信息列表

安全预警请先读我