（运营商实现该接口）处理上报失败

开发中

POST

/example/handleReportFailure

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

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

平台会通过该接口告警运营商，上报数据失败

请求参数

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

status

integer

必需

message

string

必需

data

object

必需

requestAPI

string

必需

requestParam

object

必需

requestBody

object (ChargingMetaInfo)

必需

requestId

string

必需

requestFailureCount

integer

必需

示例

{
    "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
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/example/handleReportFailure' \
--header 'Datetime: 2022-02-28 13:45:04' \
--header 'OperatorId: 运营商 id' \
--header 'Token: 平台分发的 token' \
--header 'Signature: 用户身份签名' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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
    }
}'

返回响应

🟢200成功

application/json

Body

status

integer

必需

message

string

必需

data

string

必需

示例

{
    "status": 200,
    "message": "请求成功!",
    "data": "回调成功!"
}

修改于 2022-08-05 09:26:29

删除上报失败回调地址

修改查询充电口实时数据回调地址