{ "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": [] } ] } } } }