Insert a bounded privacy-safe voice trace event batch

POST

/v1/voice-traces/events

请求参数

Body 参数application/json必填

示例

{
    "traceId": "string",
    "events": [
        {
            "traceSchemaVersion": "voice-trace-v4",
            "traceFeatureVersion": "voice-chain-v4",
            "clockDomain": "electron_renderer",
            "eventId": "string",
            "traceId": "string",
            "sessionId": "string",
            "deviceId": "string",
            "clientSessionId": "string",
            "source": "electron",
            "eventName": "physical_key_down",
            "sequence": 0,
            "monotonicMs": 0,
            "safePayload": {
                "property1": "string",
                "property2": "string"
            },
            "createdAt": "2019-08-24T14:15:22.123Z"
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/voice-traces/events' \
--header 'Content-Type: application/json' \
--data '{
    "traceId": "string",
    "events": [
        {
            "traceSchemaVersion": "voice-trace-v4",
            "traceFeatureVersion": "voice-chain-v4",
            "clockDomain": "electron_renderer",
            "eventId": "string",
            "traceId": "string",
            "sessionId": "string",
            "deviceId": "string",
            "clientSessionId": "string",
            "source": "electron",
            "eventName": "physical_key_down",
            "sequence": 0,
            "monotonicMs": 0,
            "safePayload": {
                "property1": "string",
                "property2": "string"
            },
            "createdAt": "2019-08-24T14:15:22.123Z"
        }
    ]
}'

返回响应

🟢200成功

application/json

Trace events accepted.

Bodyapplication/json

示例

{
    "endpoint": "POST /v1/voice-traces/events",
    "traceId": "string",
    "acceptedCount": 0
}

🟠400请求有误

🟠401没有权限

🟠413

修改于 2026-08-26 04:04:36

Create or upsert a privacy-safe voice trace summary

Record privacy-safe client insert acknowledgement