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

POST

/keyApi/v1/keySharingExchange

车主手机设备厂商调用----->车厂OEM。
这是车辆 OEM 服务器提供的通用 API。所有者设备向朋友设备发送 keyCreation-Request、keySigningRequest 或 importRequest 以创建共享密钥。

请求参数

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

sharingSession

object

分享会话

必需

sessionID

string

会话ID

必需

vehicleOEMUrl

string

分享URL

必需

keyAction

string

分享事件

必需

IMPORT_SHARED_KEY

keyID

string

钥匙ID

必需

importRequest

string

对称密钥

必需

示例

{
    "keyAction": "IMPORT_SHARED_KEY",
    "keyID": "4938205039594",
    "sharingSession": {
        "sessionID": "533677a1c95bf11da052d7caead6e3bbf2e3609579966169fd",
        "vehicleOEMUrl": "UrlToReachOutToVehicleOem"
    },
    "importRequest": "importRequest as per Table 11-10"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/keyApi/v1/keySharingExchange' \
--header 'x-requestId;' \
--header 'x-device-oemId;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "keyAction": "IMPORT_SHARED_KEY",
    "keyID": "4938205039594",
    "sharingSession": {
        "sessionID": "533677a1c95bf11da052d7caead6e3bbf2e3609579966169fd",
        "vehicleOEMUrl": "UrlToReachOutToVehicleOem"
    },
    "importRequest": "importRequest as per Table 11-10"
}'

返回响应

🟢201成功

application/json

Body

responseHeader

object

公共响应标头

必需

statusCode

string

状态码

必需

示例

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

钥匙分享交换-签名分享钥匙

事件通知-钥匙被终止