钥匙分享交换-创建分享钥匙

POST

/keyApi/v1/keySharingExchange

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

请求参数

Header 参数

x-requestId

string

可选

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

Body 参数application/json

sharingSession

object

分享会话

必需

sessionID

string

会话ID

必需

vehicleOEMUrl

string

分享URL

必需

keyAction

string

分享事件

必需

CREATE_SHARED_KEY

keyID

string

钥匙ID

必需

keyCreationRequest

string

对称密钥

必需

示例

{
    "keyAction": "CREATE_SHARED_KEY",
    "keyID": "c95bf1ad6533670951da052d7cae77a1e3bbf2e369966169f4",
    "sharingSession": {
        "sessionID": "533677a1c95bf11da052d7caead6e3bbf2e3609579966169fd",
        "vehicleOEMUrl": "UrlToReachOutToVehicleOem"
    },
    "keyCreationRequest": "keyCreationRequest as per Table 11-5"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/keyApi/v1/keySharingExchange' \
--header 'x-requestId;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "keyAction": "CREATE_SHARED_KEY",
    "keyID": "c95bf1ad6533670951da052d7cae77a1e3bbf2e369966169f4",
    "sharingSession": {
        "sessionID": "533677a1c95bf11da052d7caead6e3bbf2e3609579966169fd",
        "vehicleOEMUrl": "UrlToReachOutToVehicleOem"
    },
    "keyCreationRequest": "keyCreationRequest as per Table 11-5"
}'

返回响应

🟢201成功

application/json

Body

responseHeader

object

公共响应标头

必需

statusCode

string

状态码

必需

示例

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

取消分享会话

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