ChargingStationHTTPAPI
  1. 上报回调地址管理
ChargingStationHTTPAPI
  • 桩企接入流程请先读我
  • 站点数据管理
    • 充电站管理
      • 提交一个充电站信息
      • 删除一个充电站信息
      • 修改一个充电站信息
      • 分页查询多个充电站信息列表
    • 充电设施管理
      • 提交一个充电设施信息
      • 删除一个充电设施信息
      • 修改一个充电设施信息
      • 分页查询多个充电设施信息列表
    • 充电口管理
      • 提交一个充电口信息
      • 删除一个充电口信息
      • 修改一个充电口信息
      • 分页查询多个充电口信息列表
  • 实时数据上报
    • 上报回调地址管理
      • 修改上报失败回调地址
        PUT
      • 删除上报失败回调地址
        DELETE
      • (运营商实现该接口)处理上报失败
        POST
      • 修改查询充电口实时数据回调地址
        PUT
      • 修改请求上报充电过程数据地址
        DELETE
      • (运营商实现该接口)处理请求上报充电过程数据
        GET
    • 上报充电口实时信息
      POST
    • 重新上报充电口实时信息
      POST
    • 上报充电口实时信息列表
      POST
  • 运营数据管理
    • 充电记录管理
      • 提交一个充电记录信息
      • 分页查询多个充电记录信息列表
      • 提交充电记录信息列表
  • 安全预警管理
    • 安全预警请先读我
    • 修改安全预警回调地址
      PUT
    • (桩企实现)安全预警接口举例
      POST
  • 获取运营商operator token
    GET
  1. 上报回调地址管理

修改上报失败回调地址

开发中
PUT
/platform/management/callbackUrl/reportFailure
采用异步上报的方式,桩企调用 /report/chargingMetaInfo上报数据失败,会调用这个地址
每个桩企都有相应的一个 reportFailureCallbackUrl, 默认为空,即上报失败不触发回调
上报如果失败,会将如下 json 的数据通过 POST 方式,请求给回调地址
requestAPI: String, 失败的 API
requestParam: Object, 请求参数组成一个 json
requestBody: Object, 请求 body 组成一个 json
requestId: String, 用来唯一表示一条充电数据信息的id,后续的再次上报需要用到,在requestBody 中也会设置chargingMetaInfoId相应字段
requestFailureCount: Integer, 失败次数, 平台默认对一条上报数据只接受最多三次失败
status: Integer, 错误代码
message: String, 错误信息
举例
{
    "status": 401,
    "message": "权限错误",
    "data": {
        "requestAPI": "/platform/report/chargingEquipmentRunningStatus",
        "requestParam": {},
        "requestBody": {
            "cellId": "91",
            "equipmentId": "7",
            "operatorId": "80",
            "updateDatetime": "2007-03-04 08:20:25",
            "cellStatus": 80,
            "errorCode": 99,
            "current": 64,
            "voltage": 64,
            "power": 48,
            "quantity": 54,
            "temperature": 99,
            "receivedByPlatformDatetime": "1986-03-18 14:04:48",
            "doorStatus": 46,
            "chargingMetaInfoId": "由平台生成123456789",
            "startChargeSeq": "关联账单id"
        },
        "requestId": "由平台生成123456789",
        "requestFailureCount": 1
    }
}

请求参数

Query 参数
operatorId
string 
运营商唯一id
必需
示例值:
运营商唯一id
url
string 
回调地址
必需
示例值:
www.baidu.com
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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PUT '/platform/management/callbackUrl/reportFailure?operatorId=运营商唯一id&url=www.baidu.com' \
--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
string 
必需
示例
{
    "status": 200,
    "message": "请求成功!",
    "data": "修改成功!"
}
修改于 2022-03-19 09:48:45
上一页
分页查询多个充电口信息列表
下一页
删除上报失败回调地址
Built with