Files
story/openapi/call-memory.yaml
T

3368 lines
98 KiB
YAML
Raw Normal View History

{
"components": {
"schemas": {
"Envelope": {
"properties": {
"code": {
"type": "string"
},
"data": {
"additionalProperties": true,
"type": "object"
},
"message": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"recovery_action": {
"type": "string"
},
"request_id": {
"type": "string"
},
"retry_after_ms": {
"type": "integer"
},
"server_time_ms": {
"type": "integer"
}
},
"required": [
"ok",
"code",
"request_id",
"server_time_ms"
],
"type": "object"
},
"Manifest": {
"additionalProperties": false,
"properties": {
"audio_profile_id": {
"type": "string"
},
"auth_lease_expires_at_ms": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"auth_lease_ms": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"binding_generation": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"boot_id": {
"type": "string"
},
"bot_id": {
"type": "string"
},
"business_session_id": {
"type": "string"
},
"call_generation": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"context_version": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"contract_version": {
"type": "string"
},
"device_id": {
"type": "string"
},
"expires_at_ms": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"first_turn_mode": {
"type": "string"
},
"hook_event_id": {
"type": "string"
},
"issued_at_ms": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"local_notice_enabled": {
"type": "boolean"
},
"manifest_id": {
"type": "string"
},
"max_call_ms": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"memory_mode": {
"type": "string"
},
"memory_revision": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"mode": {
"type": "string"
},
"notice_profile_id": {
"type": "string"
},
"privacy_epoch": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"provider_profile_id": {
"type": "string"
},
"purpose": {
"type": "string"
},
"vendor_params_json": {
"type": "string"
},
"viking_visible_revision": {
"format": "int64",
"minimum": 0,
"type": "integer"
}
},
"required": [
"contract_version",
"manifest_id",
"business_session_id",
"device_id",
"boot_id",
"hook_event_id",
"call_generation",
"binding_generation",
"issued_at_ms",
"expires_at_ms",
"mode",
"bot_id",
"provider_profile_id",
"purpose",
"first_turn_mode",
"memory_mode",
"memory_revision",
"viking_visible_revision",
"privacy_epoch",
"context_version",
"audio_profile_id",
"vendor_params_json",
"auth_lease_ms",
"auth_lease_expires_at_ms",
"max_call_ms",
"local_notice_enabled",
"notice_profile_id"
],
"type": "object"
},
"device_calls_command-acks": {
"additionalProperties": false,
"properties": {
"business_session_id": {
"type": "string"
},
"call_generation": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"command_id": {
"type": "string"
},
"error_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"mutation_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"mutation_revision": {
"anyOf": [
{
"format": "int64",
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"phase": {
"type": "string"
}
},
"required": [
"business_session_id",
"command_id",
"call_generation",
"phase",
"error_code"
],
"type": "object"
},
"device_calls_end": {
"additionalProperties": false,
"properties": {
"binding_generation": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"boot_id": {
"type": "string"
},
"business_session_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"call_generation": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"elapsed_ms": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"hook_event_id": {
"type": "string"
},
"last_event_seq": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"local_audio_stopped": {
"type": "boolean"
},
"reason": {
"type": "string"
},
"sdk_stop_status": {
"type": "string"
}
},
"required": [
"boot_id",
"call_generation",
"binding_generation",
"reason",
"elapsed_ms",
"last_event_seq",
"local_audio_stopped",
"sdk_stop_status"
],
"type": "object"
},
"device_calls_events": {
"additionalProperties": false,
"properties": {
"binding_generation": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"boot_id": {
"type": "string"
},
"business_session_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"call_generation": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"events": {
"items": {
"additionalProperties": false,
"properties": {
"event_id": {
"type": "string"
},
"event_seq": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"media_attempt_id": {
"type": "string"
},
"monotonic_ms": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"occurred_at_ms": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"payload": {
"additionalProperties": {},
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"event_id",
"event_seq",
"type",
"monotonic_ms",
"occurred_at_ms",
"media_attempt_id",
"payload"
],
"type": "object"
},
"type": "array"
},
"hook_event_id": {
"type": "string"
}
},
"required": [
"boot_id",
"call_generation",
"binding_generation",
"events"
],
"type": "object"
},
"device_calls_heartbeat": {
"additionalProperties": false,
"properties": {
"binding_generation": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"boot_id": {
"type": "string"
},
"business_session_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"call_generation": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"hook_event_id": {
"type": "string"
},
"last_event_seq": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"manifest_id": {
"type": "string"
},
"media_attempt_id": {
"type": "string"
},
"observed_privacy_epoch": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"runtime_state": {
"type": "string"
},
"uptime_ms": {
"format": "int64",
"minimum": 0,
"type": "integer"
}
},
"required": [
"boot_id",
"call_generation",
"binding_generation",
"manifest_id",
"media_attempt_id",
"observed_privacy_epoch",
"runtime_state",
"last_event_seq",
"uptime_ms"
],
"type": "object"
},
"device_calls_prepare": {
"additionalProperties": false,
"properties": {
"audio_profile_id": {
"type": "string"
},
"binding_generation": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"boot_id": {
"type": "string"
},
"business_session_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"call_generation": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"hook_event_id": {
"type": "string"
},
"purpose": {
"type": "string"
}
},
"required": [
"boot_id",
"call_generation",
"binding_generation",
"audio_profile_id",
"purpose"
],
"type": "object"
},
"device_calls_status": {
"additionalProperties": false,
"properties": {
"boot_id": {
"type": "string"
},
"business_session_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"hook_event_id": {
"type": "string"
}
},
"required": [
"business_session_id",
"boot_id",
"hook_event_id"
],
"type": "object"
},
"device_calls_warmup": {
"additionalProperties": false,
"properties": {
"audio_profile_id": {
"type": "string"
},
"binding_generation": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"boot_id": {
"type": "string"
},
"contract_version": {
"type": "string"
},
"firmware_version": {
"type": "string"
},
"known_config_version": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"sdk_version": {
"type": "string"
}
},
"required": [
"boot_id",
"binding_generation",
"firmware_version",
"sdk_version",
"audio_profile_id",
"known_config_version"
],
"type": "object"
},
"memories_access_grant": {
"additionalProperties": false,
"properties": {
"can_read": {
"type": "boolean"
},
"can_write": {
"type": "boolean"
},
"elder_id": {
"type": "string"
},
"expected_version": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"sensitive_read": {
"type": "boolean"
},
"user_id": {
"type": "string"
}
},
"required": [
"elder_id",
"can_read",
"can_write",
"sensitive_read",
"expected_version"
],
"type": "object"
},
"memories_access_query": {
"additionalProperties": false,
"properties": {
"elder_id": {
"type": "string"
}
},
"required": [
"elder_id"
],
"type": "object"
},
"memories_mutations": {
"additionalProperties": false,
"properties": {
"action": {
"type": "string"
},
"elder_id": {
"type": "string"
},
"expected_record_versions": {
"additionalProperties": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"type": "object"
},
"mutation_id": {
"type": "string"
},
"patch": {
"additionalProperties": false,
"properties": {
"completed_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
]
},
"completion_basis": {},
"content": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entity_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"item_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"memory_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"planned_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
]
},
"proactive_policy": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sensitivity": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [],
"type": "object"
},
"scope": {
"type": "string"
},
"targets": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"mutation_id",
"elder_id",
"action",
"targets",
"expected_record_versions",
"patch"
],
"type": "object"
},
"memories_mutations_confirm": {
"additionalProperties": false,
"properties": {
"confirmation_token": {
"type": "string"
},
"decision": {
"type": "string"
},
"expected_mutation_revision": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"mutation_id": {
"type": "string"
},
"proposal_digest": {
"type": "string"
}
},
"required": [
"mutation_id",
"expected_mutation_revision",
"proposal_digest",
"confirmation_token",
"decision"
],
"type": "object"
},
"memories_mutations_resolve": {
"additionalProperties": false,
"properties": {
"expected_mutation_revision": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"expected_record_versions": {
"additionalProperties": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"type": "object"
},
"mutation_id": {
"type": "string"
},
"patch": {
"additionalProperties": false,
"properties": {
"completed_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
]
},
"completion_basis": {},
"content": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"entity_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"item_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"memory_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"planned_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
]
},
"proactive_policy": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sensitivity": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [],
"type": "object"
},
"targets": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"mutation_id",
"expected_mutation_revision",
"targets",
"expected_record_versions",
"patch"
],
"type": "object"
},
"memories_mutations_status": {
"additionalProperties": false,
"properties": {
"mutation_id": {
"type": "string"
}
},
"required": [
"mutation_id"
],
"type": "object"
},
"memories_query": {
"additionalProperties": false,
"properties": {
"cursor": {
"description": "Opaque next_cursor from the previous page. New cursors encode the immutable created_at and public_id boundary. Legacy UUID cursors are accepted only when their anchor is visible in the same authorized elder and filter scope.",
"maxLength": 1024,
"type": "string"
},
"elder_id": {
"type": "string"
},
"limit": {
"format": "int64",
"minimum": 0,
"type": "integer"
},
"memory_type": {
"type": "string"
},
"status": {
"type": "string"
}
},
"required": [
"elder_id"
],
"type": "object"
},
"memories_sync_status": {
"additionalProperties": false,
"properties": {
"elder_id": {
"type": "string"
}
},
"required": [
"elder_id"
],
"type": "object"
}
},
"securitySchemes": {
"CustomerBearer": {
"scheme": "bearer",
"type": "http"
},
"DeviceHMAC": {
"description": "Device-HMAC-SHA256 \u003chex HMAC-SHA256 of DEVREQ1 canonical bytes\u003e",
"in": "header",
"name": "Authorization",
"type": "apiKey"
}
}
},
"info": {
"title": "CALL-MEMORY-1.1",
"version": "1.1.0"
},
"openapi": "3.1.0",
"paths": {
"/api/v1/device/calls/command-acks": {
"post": {
"description": "ONBOARDING-1.1 DEVREQ1 签名原始正文。nonce 5 分钟去重,时钟偏差不超过 120 秒。事件和 status 不续租;heartbeat 必须在启动 SDK 前成功,后续每 5 秒续租,绝对期限最长 45 秒。",
"operationId": "device_calls_command-acks",
"parameters": [
{
"in": "header",
"name": "X-Request-ID",
"required": true,
"schema": {
"format": "uuid",
"type": "string"
}
},
{
"in": "header",
"name": "X-Device-ID",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Key-Version",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Timestamp-Ms",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Nonce",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/device_calls_command-acks"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"410": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"413": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"429": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"503": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
}
},
"security": [
{
"DeviceHMAC": []
}
]
}
},
"/api/v1/device/calls/end": {
"post": {
"description": "ONBOARDING-1.1 DEVREQ1 签名原始正文。nonce 5 分钟去重,时钟偏差不超过 120 秒。事件和 status 不续租;heartbeat 必须在启动 SDK 前成功,后续每 5 秒续租,绝对期限最长 45 秒。",
"operationId": "device_calls_end",
"parameters": [
{
"in": "header",
"name": "X-Request-ID",
"required": true,
"schema": {
"format": "uuid",
"type": "string"
}
},
{
"in": "header",
"name": "X-Device-ID",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Key-Version",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Timestamp-Ms",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Nonce",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/device_calls_end"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"410": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"413": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"429": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"503": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
}
},
"security": [
{
"DeviceHMAC": []
}
]
}
},
"/api/v1/device/calls/events": {
"post": {
"description": "ONBOARDING-1.1 DEVREQ1 签名原始正文。nonce 5 分钟去重,时钟偏差不超过 120 秒。事件和 status 不续租;heartbeat 必须在启动 SDK 前成功,后续每 5 秒续租,绝对期限最长 45 秒。",
"operationId": "device_calls_events",
"parameters": [
{
"in": "header",
"name": "X-Request-ID",
"required": true,
"schema": {
"format": "uuid",
"type": "string"
}
},
{
"in": "header",
"name": "X-Device-ID",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Key-Version",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Timestamp-Ms",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Nonce",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/device_calls_events"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"410": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"413": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"429": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"503": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
}
},
"security": [
{
"DeviceHMAC": []
}
]
}
},
"/api/v1/device/calls/heartbeat": {
"post": {
"description": "ONBOARDING-1.1 DEVREQ1 签名原始正文。nonce 5 分钟去重,时钟偏差不超过 120 秒。事件和 status 不续租;heartbeat 必须在启动 SDK 前成功,后续每 5 秒续租,绝对期限最长 45 秒。",
"operationId": "device_calls_heartbeat",
"parameters": [
{
"in": "header",
"name": "X-Request-ID",
"required": true,
"schema": {
"format": "uuid",
"type": "string"
}
},
{
"in": "header",
"name": "X-Device-ID",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Key-Version",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Timestamp-Ms",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Nonce",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/device_calls_heartbeat"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"410": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"413": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"429": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"503": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
}
},
"security": [
{
"DeviceHMAC": []
}
]
}
},
"/api/v1/device/calls/prepare": {
"post": {
"description": "ONBOARDING-1.1 DEVREQ1 签名原始正文。nonce 5 分钟去重,时钟偏差不超过 120 秒。事件和 status 不续租;heartbeat 必须在启动 SDK 前成功,后续每 5 秒续租,绝对期限最长 45 秒。",
"operationId": "device_calls_prepare",
"parameters": [
{
"in": "header",
"name": "X-Request-ID",
"required": true,
"schema": {
"format": "uuid",
"type": "string"
}
},
{
"in": "header",
"name": "X-Device-ID",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Key-Version",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Timestamp-Ms",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Nonce",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/device_calls_prepare"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"410": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"413": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"429": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"503": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
}
},
"security": [
{
"DeviceHMAC": []
}
]
}
},
"/api/v1/device/calls/status": {
"post": {
"description": "ONBOARDING-1.1 DEVREQ1 签名原始正文。nonce 5 分钟去重,时钟偏差不超过 120 秒。事件和 status 不续租;heartbeat 必须在启动 SDK 前成功,后续每 5 秒续租,绝对期限最长 45 秒。",
"operationId": "device_calls_status",
"parameters": [
{
"in": "header",
"name": "X-Request-ID",
"required": true,
"schema": {
"format": "uuid",
"type": "string"
}
},
{
"in": "header",
"name": "X-Device-ID",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Key-Version",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Timestamp-Ms",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Nonce",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/device_calls_status"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"410": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"413": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"429": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"503": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
}
},
"security": [
{
"DeviceHMAC": []
}
]
}
},
"/api/v1/device/calls/warmup": {
"post": {
"description": "ONBOARDING-1.1 DEVREQ1 签名原始正文。nonce 5 分钟去重,时钟偏差不超过 120 秒。事件和 status 不续租;heartbeat 必须在启动 SDK 前成功,后续每 5 秒续租,绝对期限最长 45 秒。",
"operationId": "device_calls_warmup",
"parameters": [
{
"in": "header",
"name": "X-Request-ID",
"required": true,
"schema": {
"format": "uuid",
"type": "string"
}
},
{
"in": "header",
"name": "X-Device-ID",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Key-Version",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Timestamp-Ms",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "header",
"name": "X-Nonce",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/device_calls_warmup"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"410": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"413": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"429": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"503": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
}
},
"security": [
{
"DeviceHMAC": []
}
]
}
},
"/api/v1/memories/access/grant": {
"post": {
"description": "登录用户,独立记忆权限校验。正文上限 64 KiB,拒绝重复 JSON 键和未知字段。变更需提交稳定 mutation_id 与目标 record_version。",
"operationId": "memories_access_grant",
"parameters": [
{
"in": "header",
"name": "X-Request-ID",
"required": false,
"schema": {
"format": "uuid",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/memories_access_grant"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"410": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"413": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"429": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"503": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
}
},
"security": [
{
"CustomerBearer": []
}
]
}
},
"/api/v1/memories/access/query": {
"post": {
"description": "登录用户,独立记忆权限校验。正文上限 64 KiB,拒绝重复 JSON 键和未知字段。变更需提交稳定 mutation_id 与目标 record_version。",
"operationId": "memories_access_query",
"parameters": [
{
"in": "header",
"name": "X-Request-ID",
"required": false,
"schema": {
"format": "uuid",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/memories_access_query"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"410": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"413": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"429": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"503": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
}
},
"security": [
{
"CustomerBearer": []
}
]
}
},
"/api/v1/memories/mutations": {
"post": {
"description": "登录用户,独立记忆权限校验。正文上限 64 KiB,拒绝重复 JSON 键和未知字段。变更需提交稳定 mutation_id 与目标 record_version。",
"operationId": "memories_mutations",
"parameters": [
{
"in": "header",
"name": "X-Request-ID",
"required": false,
"schema": {
"format": "uuid",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/memories_mutations"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"410": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"413": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"429": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"503": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
}
},
"security": [
{
"CustomerBearer": []
}
]
}
},
"/api/v1/memories/mutations/confirm": {
"post": {
"description": "登录用户,独立记忆权限校验。正文上限 64 KiB,拒绝重复 JSON 键和未知字段。变更需提交稳定 mutation_id 与目标 record_version。",
"operationId": "memories_mutations_confirm",
"parameters": [
{
"in": "header",
"name": "X-Request-ID",
"required": false,
"schema": {
"format": "uuid",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/memories_mutations_confirm"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"410": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"413": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"429": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"503": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
}
},
"security": [
{
"CustomerBearer": []
}
]
}
},
"/api/v1/memories/mutations/resolve": {
"post": {
"description": "登录用户,独立记忆权限校验。正文上限 64 KiB,拒绝重复 JSON 键和未知字段。变更需提交稳定 mutation_id 与目标 record_version。",
"operationId": "memories_mutations_resolve",
"parameters": [
{
"in": "header",
"name": "X-Request-ID",
"required": false,
"schema": {
"format": "uuid",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/memories_mutations_resolve"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"410": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"413": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"429": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"503": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
}
},
"security": [
{
"CustomerBearer": []
}
]
}
},
"/api/v1/memories/mutations/status": {
"post": {
"description": "登录用户,独立记忆权限校验。正文上限 64 KiB,拒绝重复 JSON 键和未知字段。变更需提交稳定 mutation_id 与目标 record_version。",
"operationId": "memories_mutations_status",
"parameters": [
{
"in": "header",
"name": "X-Request-ID",
"required": false,
"schema": {
"format": "uuid",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/memories_mutations_status"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"410": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"413": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"429": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"503": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
}
},
"security": [
{
"CustomerBearer": []
}
]
}
},
"/api/v1/memories/query": {
"post": {
"description": "登录用户,独立记忆权限校验。正文上限 64 KiB,拒绝重复 JSON 键和未知字段。data.items 按 created_at DESC、public_id DESC 稳定排序,并返回每条记忆的 created_at(date-time)和 updated_at;编辑不改变创建时间排序。data.next_cursor 为空表示末页,否则应作为不透明游标原样传入下一页。兼容旧 UUID 游标,但锚点须属于当前授权长者及相同过滤和可见范围。",
"operationId": "memories_query",
"parameters": [
{
"in": "header",
"name": "X-Request-ID",
"required": false,
"schema": {
"format": "uuid",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/memories_query"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"410": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"413": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"429": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"503": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
}
},
"security": [
{
"CustomerBearer": []
}
]
}
},
"/api/v1/memories/sync/status": {
"post": {
"description": "登录用户,独立记忆权限校验。正文上限 64 KiB,拒绝重复 JSON 键和未知字段。data 保留 upload_pending_count、extracting_count、synced_call_count,新增非负整数 insufficient_transcript_count:当前授权长者及隐私版本内,已结束且启用记忆的 DIRECT-CHAT-1 通话中,转写已进入 PARTIAL、COMPLETE 或 EMPTY 最终态,且缺少有效 USER 或 ASSISTANT 文字的通话数(包括零正文)。不含授权撤回、过期或已抑制的删除来源;按实际正文判断,不将所有 SKIPPED 任务视作文字不足。该计数仅用于说明未生成记忆的原因,不表示仍在处理。",
"operationId": "memories_sync_status",
"parameters": [
{
"in": "header",
"name": "X-Request-ID",
"required": false,
"schema": {
"format": "uuid",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/memories_sync_status"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"401": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"403": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"404": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"409": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"410": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"413": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"429": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
},
"503": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Envelope"
}
}
},
"description": "CALL-MEMORY envelope; code/recovery_action are stable, data is present on success"
}
},
"security": [
{
"CustomerBearer": []
}
]
}
}
}
}