事件通知-钥匙被终止

POST

/keyApi/v1/eventNotification

这是由设备 OEM 服务器和车辆 OEM 服务器提供的通用 API，用于在数字钥匙上传达不同的事件。
IN_TERMINATION-当所有者或分享钥匙从本地/远程源终止时，此通知从车辆 OEM 服务器发送到所有者或朋友的设备 OEM 服务器。数字钥匙尚未终止。

请求参数

Header 参数

x-requestId

string

可选

设备 OEM 服务器和车辆 OEM 服务器的所有请求都应具有 HTTP 标头“x-requestId”。该值应为包含连字符的长度为 36 的 UUID。

x-device-oemId

string

可选

设备 OEM 端点的 FQDN。车辆 OEM 使用此信息启动与设备 OEM 的通信以获取特定的 keyID。 “x-device-oem-host”应由设备 OEM 服务器发送

Body 参数application/json

keyID

string

钥匙ID

必需

eventType

string

通知事件

必需

eventData

object

事件数据

必需

keyValidTo

string

钥匙有效期结束日期

必需

keyValidFrom

string

钥匙有效期开始日期

必需

reason

string

触发事件的原因

必需

示例

{
    "keyID": "483729239475C864E4F",
    "eventType": "IN_TERMINATION",
    "eventData": {
        "keyValidTo": "2021-02-19T23:05:17.462Z",
        "keyValidFrom": "2019-02-19T23:05:17.462Z",
        "reason": "shared key being terminated"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/keyApi/v1/eventNotification' \
--header 'Content-Type: application/json' \
--data-raw '{
    "keyID": "483729239475C864E4F",
    "eventType": "IN_TERMINATION",
    "eventData": {
        "keyValidTo": "2021-02-19T23:05:17.462Z",
        "keyValidFrom": "2019-02-19T23:05:17.462Z",
        "reason": "shared key being terminated"
    }
}'

返回响应

🟢201成功

application/json

Body

responseHeader

object

公共响应标头

必需

statusCode

string

状态码

必需

示例

{
    "responseHeader": {
        "statusCode": "200"
    }
}

钥匙分享交换-导入分享钥匙

事件通知-钥匙已暂停