wangcong/story
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
bf1233d5df51308edeacfe95082c7c10ccdfd797
story/openapi/call-memory.yaml
T
Codex Local bf1233d5df
ci / verify (push) Canceled after 0s
Details
feat: expand companion platform, device controls, and memoir workflows 
Add customer and operator login, BLE provisioning, device fleet controls, call memory, memoir generation, and refreshed family and maintenance portals. Include API contracts, migrations, firmware sources, tests, assets, and deployment documentation.
2026-10-08 10:06:44 +08:00

3368 lines
98 KiB
YAML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"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": []
}
]
}
}
}
}
Reference in New Issue View Git Blame Copy Permalink