{
  "components": {
    "schemas": {
      "ApprovedSourceList": {
        "properties": {
          "sources": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "id": {
                  "format": "uuid",
                  "type": "string"
                },
                "kind": {
                  "enum": [
                    "directory",
                    "androidTree",
                    "appleBookmark"
                  ]
                },
                "name": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "name",
                "kind"
              ],
              "type": "object"
            },
            "maxItems": 64,
            "type": "array"
          }
        },
        "required": [
          "sources"
        ],
        "type": "object"
      },
      "ArchiveSelectionCancel": {
        "additionalProperties": false,
        "properties": {
          "selection": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "selection"
        ],
        "type": "object"
      },
      "ArchiveSelectionPrepare": {
        "additionalProperties": false,
        "properties": {
          "ids": {
            "items": {
              "maxLength": 4096,
              "minLength": 1,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            },
            "maxItems": 20000,
            "minItems": 1,
            "type": "array",
            "uniqueItems": true
          },
          "path": {
            "maxLength": 4096,
            "type": "string",
            "x-legnasend-max-utf8-bytes": 4096
          }
        },
        "required": [
          "path",
          "ids"
        ],
        "type": "object"
      },
      "ArchiveSelectionTicket": {
        "additionalProperties": false,
        "properties": {
          "downloadUrl": {
            "description": "同源集成 API URL，每次 HEAD/GET 仍需同一 Authorization，不含凭据。",
            "type": "string"
          },
          "expiresIn": {
            "maximum": 120,
            "minimum": 1,
            "type": "integer"
          },
          "selectedEntries": {
            "maximum": 20000,
            "minimum": 1,
            "type": "integer"
          },
          "selection": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "selection",
          "selectedEntries",
          "expiresIn",
          "downloadUrl"
        ],
        "type": "object"
      },
      "CacheReport": {
        "additionalProperties": false,
        "properties": {
          "active": {
            "minimum": 0,
            "type": "integer"
          },
          "budgetReached": {
            "type": "boolean"
          },
          "entries": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "disposition": {
                  "enum": [
                    "candidate",
                    "removed",
                    "retired",
                    "retained",
                    "active",
                    "failed"
                  ],
                  "type": "string"
                },
                "id": {
                  "pattern": "^[a-f0-9]{64}$",
                  "type": "string"
                },
                "plannedBytes": {
                  "minimum": 0,
                  "type": "integer"
                },
                "reason": {
                  "maxLength": 80,
                  "type": "string"
                },
                "sourceKind": {
                  "enum": [
                    "unknown",
                    "nativeReceive",
                    "directoryUpload"
                  ],
                  "type": "string"
                },
                "unlinkedBytes": {
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "required": [
                "id",
                "sourceKind",
                "disposition",
                "reason",
                "plannedBytes",
                "unlinkedBytes"
              ],
              "type": "object"
            },
            "maxItems": 128,
            "type": "array"
          },
          "entriesTruncated": {
            "type": "boolean"
          },
          "examined": {
            "minimum": 0,
            "type": "integer"
          },
          "failed": {
            "minimum": 0,
            "type": "integer"
          },
          "interrupted": {
            "type": "boolean"
          },
          "plannedBytes": {
            "minimum": 0,
            "type": "integer"
          },
          "removedFiles": {
            "minimum": 0,
            "type": "integer"
          },
          "removedRecords": {
            "minimum": 0,
            "type": "integer"
          },
          "retained": {
            "minimum": 0,
            "type": "integer"
          },
          "unlinkedBytes": {
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "active",
          "budgetReached",
          "entries",
          "entriesTruncated",
          "examined",
          "failed",
          "interrupted",
          "plannedBytes",
          "removedFiles",
          "removedRecords",
          "retained",
          "unlinkedBytes"
        ],
        "type": "object"
      },
      "Capabilities": {
        "properties": {
          "apiVersion": {
            "const": 1
          },
          "operations": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "originalProtocol": {
            "type": "string"
          },
          "product": {
            "const": "LegnaSend"
          },
          "rangeDownload": {
            "type": "boolean"
          },
          "readOnly": {
            "type": "boolean"
          },
          "version": {
            "type": "string"
          }
        },
        "required": [
          "product",
          "version",
          "apiVersion",
          "operations",
          "rangeDownload",
          "readOnly",
          "originalProtocol"
        ],
        "type": "object"
      },
      "ClearRequest": {
        "additionalProperties": false,
        "properties": {
          "expectedGeneration": {
            "minimum": 1,
            "type": "integer"
          },
          "instanceId": {
            "format": "uuid",
            "type": "string"
          },
          "throughSequence": {
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "instanceId",
          "expectedGeneration",
          "throughSequence"
        ],
        "type": "object"
      },
      "ClearResult": {
        "properties": {
          "clearedThrough": {
            "type": "integer"
          },
          "generation": {
            "type": "integer"
          },
          "instanceId": {
            "type": "string"
          },
          "latest": {
            "type": "integer"
          },
          "removed": {
            "type": "integer"
          },
          "throughSequence": {
            "type": "integer"
          }
        },
        "required": [
          "instanceId",
          "generation",
          "clearedThrough",
          "throughSequence",
          "removed",
          "latest"
        ],
        "type": "object"
      },
      "ConfigureWorkspaceBody": {
        "additionalProperties": false,
        "minProperties": 1,
        "properties": {
          "slug": {
            "maxLength": 48,
            "type": "string"
          },
          "sourceId": {
            "format": "uuid",
            "type": "string"
          }
        },
        "type": "object"
      },
      "CreateWorkspaceBody": {
        "additionalProperties": false,
        "properties": {
          "allowUpload": {
            "default": false,
            "type": "boolean"
          },
          "name": {
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "slug": {
            "maxLength": 48,
            "type": "string"
          },
          "sourceId": {
            "format": "uuid",
            "type": "string"
          },
          "visible": {
            "default": true,
            "type": "boolean"
          }
        },
        "required": [
          "sourceId",
          "name",
          "slug"
        ],
        "type": "object"
      },
      "Device": {
        "additionalProperties": false,
        "properties": {
          "alias": {
            "maxLength": 1024,
            "type": "string"
          },
          "channels": {
            "items": {
              "$ref": "#/components/schemas/DeviceChannel"
            },
            "maxItems": 32,
            "type": "array"
          },
          "deviceType": {
            "enum": [
              "mobile",
              "desktop",
              "web",
              "headless",
              "server"
            ]
          },
          "id": {
            "format": "uuid",
            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
            "type": "string"
          }
        },
        "required": [
          "id",
          "alias",
          "deviceType",
          "channels"
        ],
        "type": "object"
      },
      "DeviceChannel": {
        "additionalProperties": false,
        "properties": {
          "host": {
            "description": "Discovered IP address with optional IPv6 scope, not a caller URL",
            "type": "string"
          },
          "https": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
            "type": "string"
          },
          "port": {
            "maximum": 65535,
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "id",
          "host",
          "port",
          "https"
        ],
        "type": "object"
      },
      "DeviceList": {
        "additionalProperties": false,
        "properties": {
          "devices": {
            "items": {
              "$ref": "#/components/schemas/Device"
            },
            "maxItems": 512,
            "type": "array"
          },
          "localRoutes": {
            "description": "从 devices.read 响应的 localRoutes 选择当前 UUID；省略为自动。失效返回 409 local_route_unavailable，不回退其他网络。重试继承原任务选择。androidNetwork 表示已识别系统 Network 的逐套接字绑定；来源/接口约束不保证绕过 VPN。",
            "items": {
              "$ref": "#/components/schemas/LocalRoute"
            },
            "maxItems": 64,
            "type": "array"
          },
          "scanState": {
            "enum": [
              "idle",
              "running",
              "failed"
            ]
          },
          "truncated": {
            "type": "boolean"
          }
        },
        "required": [
          "devices",
          "truncated",
          "scanState"
        ],
        "type": "object"
      },
      "DeviceResult": {
        "additionalProperties": false,
        "properties": {
          "device": {
            "$ref": "#/components/schemas/Device"
          }
        },
        "required": [
          "device"
        ],
        "type": "object"
      },
      "DocumentPreviewLease": {
        "additionalProperties": false,
        "properties": {
          "etag": {
            "pattern": "^\"[a-f0-9]{64}\"$",
            "type": "string"
          },
          "lease": {
            "format": "uuid",
            "type": "string"
          },
          "mime": {
            "maxLength": 256,
            "type": "string"
          },
          "size": {
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "url": {
            "description": "同源集成 API 内容网址，包含代次与租约，后续请求仍须 Authorization。",
            "type": "string"
          }
        },
        "required": [
          "url",
          "size",
          "etag",
          "mime",
          "lease"
        ],
        "type": "object"
      },
      "Entry": {
        "properties": {
          "directory": {
            "type": "boolean"
          },
          "downloadable": {
            "type": "boolean"
          },
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "size": {
            "description": "文档提供程序可能返回未知大小 null，不是零字节。",
            "minimum": 0,
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "name",
          "directory",
          "size"
        ],
        "type": "object"
      },
      "Error": {
        "properties": {
          "error": {
            "properties": {
              "code": {
                "type": "string"
              },
              "reason": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "requestId": {
                "type": "string"
              }
            },
            "required": [
              "code",
              "requestId"
            ],
            "type": "object"
          }
        },
        "required": [
          "error"
        ],
        "type": "object"
      },
      "FilePage": {
        "properties": {
          "anchorMissing": {
            "type": "boolean"
          },
          "anchorPending": {
            "type": "boolean"
          },
          "contentEpoch": {
            "description": "持久保存的有限范围元数据观察状态，不是全目录内容哈希或文件校验值。启动、待持久化或不确定时为 unknown；通知仅提示重新核验。下载仍使用逐文件 ETag/If-Match。",
            "format": "uuid",
            "type": [
              "string",
              "null"
            ]
          },
          "contentKnowledge": {
            "description": "持久保存的有限范围元数据观察状态，不是全目录内容哈希或文件校验值。启动、待持久化或不确定时为 unknown；通知仅提示重新核验。下载仍使用逐文件 ETag/If-Match。",
            "enum": [
              "observed",
              "unknown"
            ],
            "type": "string"
          },
          "contentRevision": {
            "description": "持久保存的有限范围元数据观察状态，不是全目录内容哈希或文件校验值。启动、待持久化或不确定时为 unknown；通知仅提示重新核验。下载仍使用逐文件 ETag/If-Match。",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "dirty": {
            "description": "持久保存的有限范围元数据观察状态，不是全目录内容哈希或文件校验值。启动、待持久化或不确定时为 unknown；通知仅提示重新核验。下载仍使用逐文件 ETag/If-Match。",
            "type": "boolean"
          },
          "entries": {
            "items": {
              "$ref": "#/components/schemas/Entry"
            },
            "type": "array"
          },
          "filter": {
            "maxLength": 256,
            "type": "string"
          },
          "generation": {
            "type": "integer"
          },
          "lastObservedAt": {
            "description": "上次已持久保存的观察时间，Unix 毫秒；null 表示尚无确认值。",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": [
              "integer",
              "null"
            ]
          },
          "offset": {
            "minimum": 0,
            "type": "integer"
          },
          "path": {
            "type": "string"
          },
          "scanned": {
            "type": "integer"
          },
          "stamp": {
            "description": "不透明目录元数据校验值，并非内容哈希",
            "type": "string"
          }
        },
        "required": [
          "entries",
          "cursor",
          "generation",
          "path",
          "scanned",
          "contentEpoch",
          "contentKnowledge",
          "contentRevision",
          "dirty",
          "lastObservedAt",
          "filter"
        ],
        "type": "object"
      },
      "HostSettings": {
        "additionalProperties": false,
        "properties": {
          "pendingRestart": {
            "items": {
              "enum": [
                "alias",
                "verifyChecksums"
              ],
              "type": "string"
            },
            "maxItems": 2,
            "type": "array",
            "uniqueItems": true
          },
          "receiveCacheRetention": {
            "$ref": "#/components/schemas/ReceiveCacheRetention"
          },
          "settings": {
            "additionalProperties": false,
            "properties": {
              "alias": {
                "maxLength": 120,
                "type": "string"
              },
              "autoFinish": {
                "type": "boolean"
              },
              "createChecksums": {
                "type": "boolean"
              },
              "enableAnimations": {
                "type": "boolean"
              },
              "locale": {
                "description": "Supported app language tag, or system",
                "type": "string"
              },
              "receiveCacheRetentionDays": {
                "description": "原生接收崩溃残留保留期：-2 为 1 小时（默认），-1 等待本地手动清理，0 在下次维护时不延迟清理，1–3650 为天数；更改策略本身不会执行清理。只处理已登记且非活动的原生残留；不授予立即清理覆盖、不影响正常取消，也不代表可断点续传。",
                "maximum": 3650,
                "minimum": -2,
                "type": "integer"
              },
              "theme": {
                "enum": [
                  "system",
                  "light",
                  "dark"
                ],
                "type": "string"
              },
              "verifyChecksums": {
                "type": "boolean"
              }
            },
            "required": [
              "alias",
              "theme",
              "locale",
              "enableAnimations",
              "autoFinish",
              "createChecksums",
              "verifyChecksums",
              "receiveCacheRetentionDays"
            ],
            "type": "object"
          },
          "version": {
            "pattern": "^[a-f0-9]{64}$",
            "type": "string"
          }
        },
        "required": [
          "version",
          "settings",
          "pendingRestart",
          "receiveCacheRetention"
        ],
        "type": "object"
      },
      "KeyCreate": {
        "additionalProperties": false,
        "properties": {
          "expiresAt": {
            "minimum": 0,
            "type": [
              "integer",
              "null"
            ]
          },
          "grant": {
            "additionalProperties": false,
            "properties": {
              "scopes": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "workspaces": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            },
            "required": [
              "scopes",
              "workspaces"
            ],
            "type": "object"
          },
          "name": {
            "maxLength": 256,
            "type": "string"
          },
          "requestId": {
            "format": "uuid",
            "type": "string"
          },
          "version": {
            "pattern": "^[a-f0-9]{64}$",
            "type": "string"
          }
        },
        "required": [
          "version",
          "requestId",
          "name",
          "grant",
          "expiresAt"
        ],
        "type": "object"
      },
      "KeyList": {
        "additionalProperties": false,
        "properties": {
          "keys": {
            "items": {
              "$ref": "#/components/schemas/KeyMetadata"
            },
            "maxItems": 128,
            "type": "array"
          },
          "version": {
            "pattern": "^[a-f0-9]{64}$",
            "type": "string"
          }
        },
        "required": [
          "version",
          "keys"
        ],
        "type": "object"
      },
      "KeyManage": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "enum": [
              "pause",
              "resume",
              "revoke"
            ],
            "type": "string"
          },
          "requestId": {
            "format": "uuid",
            "type": "string"
          },
          "version": {
            "pattern": "^[a-f0-9]{64}$",
            "type": "string"
          }
        },
        "required": [
          "version",
          "requestId",
          "action"
        ],
        "type": "object"
      },
      "KeyMetadata": {
        "additionalProperties": false,
        "properties": {
          "createdAt": {
            "type": "integer"
          },
          "enabled": {
            "type": "boolean"
          },
          "expiresAt": {
            "type": [
              "integer",
              "null"
            ]
          },
          "grant": {
            "type": "object"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "limits": {
            "type": [
              "object",
              "null"
            ]
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "grant",
          "createdAt",
          "expiresAt",
          "enabled",
          "limits"
        ],
        "type": "object"
      },
      "KeyReceipt": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "enum": [
              "create",
              "pause",
              "resume",
              "revoke"
            ],
            "type": "string"
          },
          "createdAt": {
            "type": "integer"
          },
          "digest": {
            "pattern": "^[a-f0-9]{64}$",
            "type": "string"
          },
          "keyId": {
            "format": "uuid",
            "type": "string"
          },
          "principal": {
            "format": "uuid",
            "type": "string"
          },
          "requestId": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "principal",
          "requestId",
          "digest",
          "action",
          "keyId",
          "createdAt"
        ],
        "type": "object"
      },
      "KeyResult": {
        "additionalProperties": false,
        "properties": {
          "applied": {
            "description": "Current listener acknowledged persisted configuration",
            "type": "boolean"
          },
          "receipt": {
            "$ref": "#/components/schemas/KeyReceipt"
          },
          "secret": {
            "description": "Only the first successful create response. Never returned by replay or receipt lookup. Store privately, not in logs.",
            "readOnly": true,
            "type": "string"
          },
          "secretAvailable": {
            "type": "boolean"
          }
        },
        "required": [
          "receipt",
          "applied",
          "secretAvailable"
        ],
        "type": "object"
      },
      "Limits": {
        "description": "0 仅停用该维度；仍受其他配额及全局 64 个活动响应上限约束。",
        "properties": {
          "concurrent": {
            "maximum": 64,
            "minimum": 0,
            "type": "integer"
          },
          "perMinute": {
            "maximum": 60000,
            "minimum": 0,
            "type": "integer"
          },
          "perSecond": {
            "maximum": 1000,
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "perSecond",
          "perMinute",
          "concurrent"
        ],
        "type": "object"
      },
      "LocalRoute": {
        "additionalProperties": false,
        "properties": {
          "address": {
            "maxLength": 64,
            "type": "string"
          },
          "binding": {
            "description": "从 devices.read 响应的 localRoutes 选择当前 UUID；省略为自动。失效返回 409 local_route_unavailable，不回退其他网络。重试继承原任务选择。androidNetwork 表示已识别系统 Network 的逐套接字绑定；来源/接口约束不保证绕过 VPN。",
            "enum": [
              "interfaceAndSource",
              "sourceOnly",
              "androidNetwork"
            ]
          },
          "id": {
            "format": "uuid",
            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
            "type": "string"
          },
          "interfaceName": {
            "maxLength": 256,
            "type": "string"
          }
        },
        "required": [
          "id",
          "interfaceName",
          "address",
          "binding"
        ],
        "type": "object"
      },
      "ManagedWorkspace": {
        "additionalProperties": false,
        "properties": {
          "allowUpload": {
            "type": "boolean"
          },
          "enabled": {
            "type": "boolean"
          },
          "generation": {
            "minimum": 1,
            "type": "integer"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "invalidReason": {
            "enum": [
              null,
              "missing",
              "notDirectory",
              "permissionDenied",
              "grantUnavailable",
              "ioError",
              "timeout"
            ],
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "passwordProtected": {
            "type": "boolean"
          },
          "slug": {
            "type": "string"
          },
          "visible": {
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "generation",
          "enabled",
          "visible",
          "allowUpload",
          "passwordProtected",
          "invalidReason"
        ],
        "type": "object"
      },
      "ManagedWorkspaceList": {
        "properties": {
          "workspaces": {
            "items": {
              "$ref": "#/components/schemas/ManagedWorkspace"
            },
            "maxItems": 256,
            "type": "array"
          }
        },
        "required": [
          "workspaces"
        ],
        "type": "object"
      },
      "ManagementResult": {
        "properties": {
          "destroyed": {
            "type": "boolean"
          },
          "error": {
            "properties": {
              "code": {
                "type": "string"
              },
              "requestId": {
                "format": "uuid",
                "type": "string"
              }
            },
            "required": [
              "code",
              "requestId"
            ],
            "type": "object"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "workspace": {
            "$ref": "#/components/schemas/ManagedWorkspace"
          }
        },
        "type": "object"
      },
      "NativeTask": {
        "additionalProperties": false,
        "properties": {
          "actions": {
            "items": {
              "enum": [
                "cancel",
                "accept",
                "reject",
                "remove"
              ]
            },
            "type": "array"
          },
          "bytesPerSecond": {
            "minimum": 0,
            "type": "integer"
          },
          "direction": {
            "enum": [
              "send",
              "receive"
            ]
          },
          "fileCount": {
            "minimum": 0,
            "type": "integer"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "phase": {
            "enum": [
              "queued",
              "preparing",
              "waiting",
              "transferring",
              "succeeded",
              "failed",
              "canceled"
            ]
          },
          "totalBytes": {
            "minimum": 0,
            "type": "integer"
          },
          "transferredBytes": {
            "minimum": 0,
            "type": "integer"
          },
          "version": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "id",
          "version",
          "direction",
          "phase",
          "fileCount",
          "totalBytes",
          "transferredBytes",
          "bytesPerSecond",
          "actions"
        ],
        "type": "object"
      },
      "NativeTaskControl": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "enum": [
              "cancel",
              "accept",
              "reject",
              "remove"
            ],
            "type": "string"
          },
          "epoch": {
            "format": "uuid",
            "type": "string"
          },
          "version": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "epoch",
          "version",
          "action"
        ],
        "type": "object"
      },
      "NativeTaskControlResult": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "enum": [
              "cancel",
              "accept",
              "reject",
              "remove"
            ]
          },
          "dispatched": {
            "const": true
          },
          "epoch": {
            "format": "uuid",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "epoch",
          "id",
          "action",
          "dispatched"
        ],
        "type": "object"
      },
      "NativeTaskList": {
        "additionalProperties": false,
        "properties": {
          "epoch": {
            "format": "uuid",
            "type": "string"
          },
          "tasks": {
            "items": {
              "$ref": "#/components/schemas/NativeTask"
            },
            "maxItems": 512,
            "type": "array"
          },
          "truncated": {
            "type": "boolean"
          }
        },
        "required": [
          "epoch",
          "tasks",
          "truncated"
        ],
        "type": "object"
      },
      "ReceiveCacheRetention": {
        "additionalProperties": false,
        "allOf": [
          {
            "if": {
              "properties": {
                "effectiveDays": {
                  "type": "null"
                }
              },
              "required": [
                "effectiveDays"
              ]
            },
            "then": {
              "properties": {
                "automaticCleanupPaused": {
                  "const": true
                }
              }
            }
          },
          {
            "if": {
              "properties": {
                "busy": {
                  "const": true
                }
              },
              "required": [
                "busy"
              ]
            },
            "then": {
              "properties": {
                "automaticCleanupPaused": {
                  "const": true
                }
              }
            }
          }
        ],
        "properties": {
          "automaticCleanupPaused": {
            "description": "仅表示原生策略同步保护是否暂停自动清理。手动保留模式可为 false，但核心仍保留文件；Android 提供者清理独立管理。",
            "type": "boolean"
          },
          "busy": {
            "description": "本地保留期变更正在处理；API 不覆盖进行中的变更。",
            "type": "boolean"
          },
          "effectiveDays": {
            "description": "原生当前生效的保留期编码（-2 为 1 小时）；null 表示尚未确认，不应以保存值猜测。",
            "maximum": 3650,
            "minimum": -2,
            "type": [
              "integer",
              "null"
            ]
          },
          "error": {
            "description": "稳定且不含路径的状态原因：invalid 表示已保存的偏好损坏，而非 API 输入校验失败；save、apply、restore 分别表示保存、应用、恢复失败；null 表示无错误。",
            "enum": [
              null,
              "invalid",
              "save",
              "apply",
              "restore"
            ],
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "effectiveDays",
          "automaticCleanupPaused",
          "busy",
          "error"
        ],
        "type": "object"
      },
      "RequestPage": {
        "properties": {
          "clearedThrough": {
            "minimum": 0,
            "type": "integer"
          },
          "entries": {
            "items": {
              "$ref": "#/components/schemas/RequestRecord"
            },
            "type": "array"
          },
          "generation": {
            "minimum": 1,
            "type": "integer"
          },
          "instanceId": {
            "format": "uuid",
            "type": "string"
          },
          "latest": {
            "type": "integer"
          },
          "next": {
            "type": "integer"
          },
          "oldest": {
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "required": [
          "entries",
          "next",
          "oldest",
          "latest",
          "generation",
          "clearedThrough",
          "instanceId"
        ],
        "type": "object"
      },
      "RequestRecord": {
        "properties": {
          "bytes": {
            "minimum": 0,
            "type": "integer"
          },
          "elapsedMs": {
            "minimum": 0,
            "type": "integer"
          },
          "error": {
            "type": [
              "string",
              "null"
            ]
          },
          "method": {
            "enum": [
              "GET",
              "HEAD",
              "OPTIONS",
              "POST",
              "OTHER"
            ],
            "type": "string"
          },
          "operation": {
            "type": "string"
          },
          "outcome": {
            "type": "string"
          },
          "principal": {
            "type": [
              "string",
              "null"
            ]
          },
          "reason": {
            "type": [
              "string",
              "null"
            ]
          },
          "requestId": {
            "format": "uuid",
            "type": "string"
          },
          "sequence": {
            "minimum": 1,
            "type": "integer"
          },
          "status": {
            "maximum": 599,
            "minimum": 100,
            "type": "integer"
          },
          "timestamp": {
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "sequence",
          "timestamp",
          "requestId",
          "operation",
          "method",
          "principal",
          "status",
          "outcome",
          "error",
          "reason",
          "bytes",
          "elapsedMs"
        ],
        "type": "object"
      },
      "RetryTransferBody": {
        "additionalProperties": false,
        "properties": {
          "requestId": {
            "format": "uuid",
            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
            "type": "string"
          }
        },
        "required": [
          "requestId"
        ],
        "type": "object"
      },
      "ScanResult": {
        "additionalProperties": false,
        "properties": {
          "accepted": {
            "const": true
          },
          "coalesced": {
            "type": "boolean"
          }
        },
        "required": [
          "accepted",
          "coalesced"
        ],
        "type": "object"
      },
      "SendSelection": {
        "additionalProperties": false,
        "properties": {
          "files": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "name": {
                  "description": "仅文件基本名称，不含本地路径",
                  "maxLength": 1024,
                  "type": "string"
                },
                "size": {
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "required": [
                "name",
                "size"
              ],
              "type": "object"
            },
            "maxItems": 100,
            "type": "array"
          },
          "selectionVersion": {
            "format": "uuid",
            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
            "type": "string"
          },
          "totalBytes": {
            "minimum": 0,
            "type": "integer"
          },
          "totalCount": {
            "minimum": 0,
            "type": "integer"
          },
          "truncated": {
            "type": "boolean"
          }
        },
        "required": [
          "selectionVersion",
          "totalCount",
          "totalBytes",
          "truncated",
          "files"
        ],
        "type": "object"
      },
      "SendTransferBody": {
        "additionalProperties": false,
        "properties": {
          "channelId": {
            "format": "uuid",
            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
            "type": "string"
          },
          "deviceId": {
            "format": "uuid",
            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
            "type": "string"
          },
          "localRouteId": {
            "description": "从 devices.read 响应的 localRoutes 选择当前 UUID；省略为自动。失效返回 409 local_route_unavailable，不回退其他网络。重试继承原任务选择。androidNetwork 表示已识别系统 Network 的逐套接字绑定；来源/接口约束不保证绕过 VPN。",
            "format": "uuid",
            "type": "string"
          },
          "requestId": {
            "format": "uuid",
            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
            "type": "string"
          },
          "selectionVersion": {
            "format": "uuid",
            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
            "type": "string"
          }
        },
        "required": [
          "deviceId",
          "selectionVersion",
          "requestId"
        ],
        "type": "object"
      },
      "SourceEndCleanupReceipt": {
        "additionalProperties": false,
        "allOf": [
          {
            "if": {
              "properties": {
                "removedFiles": {
                  "const": 0
                }
              }
            },
            "then": {
              "properties": {
                "unlinkedBytes": {
                  "const": 0
                }
              }
            }
          }
        ],
        "description": "接收端确认移除的临时文件数量与逻辑字节数，不代表实际释放的磁盘空间；已发布文件保留。未确认的结果与旧通知不附带此回执。回执编号不具有清理授权能力。",
        "properties": {
          "receiptId": {
            "format": "uuid",
            "type": "string"
          },
          "removedFiles": {
            "maximum": 2,
            "minimum": 0,
            "type": "integer"
          },
          "unlinkedBytes": {
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "receiptId",
          "removedFiles",
          "unlinkedBytes"
        ],
        "type": "object"
      },
      "SourceEndNotice": {
        "additionalProperties": false,
        "allOf": [
          {
            "if": {
              "required": [
                "cleanup"
              ]
            },
            "then": {
              "properties": {
                "state": {
                  "enum": [
                    "removed",
                    "publishedPreserved"
                  ]
                }
              }
            }
          }
        ],
        "properties": {
          "attempts": {
            "minimum": 0,
            "type": "integer"
          },
          "cleanup": {
            "$ref": "#/components/schemas/SourceEndCleanupReceipt"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "name": {
            "maxLength": 255,
            "type": "string"
          },
          "peerLabel": {
            "maxLength": 120,
            "type": "string"
          },
          "state": {
            "enum": [
              "pending",
              "waitingPeer",
              "sharedSource",
              "busy",
              "authorizationRequired",
              "removed",
              "publishedPreserved",
              "unknown",
              "expired",
              "unsupported",
              "superseded"
            ]
          },
          "updatedAtUnixMs": {
            "minimum": 0,
            "type": "integer"
          },
          "version": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "id",
          "version",
          "peerLabel",
          "name",
          "state",
          "attempts",
          "updatedAtUnixMs"
        ],
        "type": "object"
      },
      "SourceEndNoticeList": {
        "additionalProperties": false,
        "properties": {
          "notices": {
            "items": {
              "$ref": "#/components/schemas/SourceEndNotice"
            },
            "maxItems": 512,
            "type": "array"
          },
          "truncated": {
            "type": "boolean"
          }
        },
        "required": [
          "notices",
          "truncated"
        ],
        "type": "object"
      },
      "SourceEndRetry": {
        "additionalProperties": false,
        "properties": {
          "requestId": {
            "format": "uuid",
            "type": "string"
          },
          "version": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "version",
          "requestId"
        ],
        "type": "object"
      },
      "SourceEndRetryResult": {
        "additionalProperties": false,
        "properties": {
          "accepted": {
            "const": true
          },
          "notice": {
            "$ref": "#/components/schemas/SourceEndNotice"
          }
        },
        "required": [
          "notice",
          "accepted"
        ],
        "type": "object"
      },
      "Status": {
        "properties": {
          "activeResponses": {
            "minimum": 0,
            "type": "integer"
          },
          "anonymousLimits": {
            "$ref": "#/components/schemas/Limits"
          },
          "authRequired": {
            "type": "boolean"
          },
          "enabled": {
            "type": "boolean"
          },
          "fixedWindowSeconds": {
            "const": [
              1,
              60
            ]
          },
          "globalLimits": {
            "$ref": "#/components/schemas/Limits"
          },
          "https": {
            "type": "boolean"
          },
          "instanceId": {
            "format": "uuid",
            "type": "string"
          },
          "keyLimits": {
            "$ref": "#/components/schemas/Limits"
          },
          "port": {
            "maximum": 65535,
            "minimum": 1,
            "type": "integer"
          },
          "principal": {
            "type": [
              "string",
              "null"
            ]
          },
          "scopes": {
            "items": {
              "enum": [
                "service.read",
                "workspaces.read",
                "files.read",
                "requests.read",
                "files.upload",
                "workspaces.manage",
                "devices.read",
                "devices.scan",
                "transfers.read",
                "transfers.send",
                "transfers.control",
                "cache.read",
                "cache.clean",
                "settings.read",
                "settings.write",
                "keys.manage",
                "requests.manage",
                "nativeTasks.read",
                "nativeTasks.control"
              ],
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "instanceId",
          "enabled",
          "authRequired",
          "port",
          "https",
          "globalLimits",
          "keyLimits",
          "anonymousLimits",
          "activeResponses",
          "principal",
          "scopes",
          "fixedWindowSeconds"
        ],
        "type": "object"
      },
      "TransferList": {
        "additionalProperties": false,
        "properties": {
          "tasks": {
            "items": {
              "$ref": "#/components/schemas/TransferTask"
            },
            "maxItems": 512,
            "type": "array"
          }
        },
        "required": [
          "tasks"
        ],
        "type": "object"
      },
      "TransferReceipt": {
        "additionalProperties": false,
        "properties": {
          "replayed": {
            "type": "boolean"
          },
          "task": {
            "$ref": "#/components/schemas/TransferTask"
          }
        },
        "required": [
          "task",
          "replayed"
        ],
        "type": "object"
      },
      "TransferRemoval": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "format": "uuid",
            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
            "type": "string"
          },
          "removed": {
            "const": true
          }
        },
        "required": [
          "removed",
          "id"
        ],
        "type": "object"
      },
      "TransferResult": {
        "additionalProperties": false,
        "properties": {
          "task": {
            "$ref": "#/components/schemas/TransferTask"
          }
        },
        "required": [
          "task"
        ],
        "type": "object"
      },
      "TransferTask": {
        "additionalProperties": false,
        "properties": {
          "bytesPerSecond": {
            "minimum": 0,
            "type": "number"
          },
          "deviceId": {
            "format": "uuid",
            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
            "type": "string"
          },
          "fileCount": {
            "minimum": 0,
            "type": "integer"
          },
          "id": {
            "format": "uuid",
            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
            "type": "string"
          },
          "localRouteId": {
            "format": "uuid",
            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
            "type": "string"
          },
          "removed": {
            "const": true
          },
          "result": {
            "enum": [
              "waiting",
              "recipientBusy",
              "declined",
              "tooManyAttempts",
              "sending",
              "finished",
              "finishedWithErrors",
              "canceledBySender",
              "canceledByReceiver"
            ]
          },
          "retryOf": {
            "format": "uuid",
            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
            "type": "string"
          },
          "status": {
            "enum": [
              "queued",
              "running",
              "succeeded",
              "failed",
              "canceled"
            ]
          },
          "totalBytes": {
            "minimum": 0,
            "type": "integer"
          },
          "transferredBytes": {
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "id",
          "deviceId",
          "status",
          "fileCount",
          "totalBytes",
          "transferredBytes",
          "bytesPerSecond"
        ],
        "type": "object"
      },
      "UploadReceipt": {
        "properties": {
          "directory": {
            "type": "boolean"
          },
          "parent": {
            "description": "文档工作区返回原请求的父目录 ID；文件系统不增加此字段。",
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "sha256": {
            "pattern": "^[a-f0-9]{64}$",
            "type": "string"
          },
          "size": {
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "path",
          "size",
          "sha256",
          "directory"
        ],
        "type": "object"
      },
      "Workspace": {
        "properties": {
          "allowUpload": {
            "type": "boolean"
          },
          "backend": {
            "enum": [
              "filesystem",
              "documents"
            ],
            "type": "string"
          },
          "capabilities": {
            "description": "按工作区来源提供能力；文档提供程序支持只读列表、单次下载、显式预览租约、有界 ZIP 及当前目录状态提示，不代表持久下载续传。",
            "properties": {
              "archive": {
                "type": "boolean"
              },
              "capture": {
                "type": "boolean"
              },
              "events": {
                "type": "boolean"
              },
              "preview": {
                "type": "boolean"
              },
              "resume": {
                "type": "boolean"
              },
              "state": {
                "type": "boolean"
              }
            },
            "type": "object"
          },
          "contentEpoch": {
            "description": "持久保存的有限范围元数据观察状态，不是全目录内容哈希或文件校验值。启动、待持久化或不确定时为 unknown；通知仅提示重新核验。下载仍使用逐文件 ETag/If-Match。",
            "format": "uuid",
            "type": [
              "string",
              "null"
            ]
          },
          "contentKnowledge": {
            "description": "持久保存的有限范围元数据观察状态，不是全目录内容哈希或文件校验值。启动、待持久化或不确定时为 unknown；通知仅提示重新核验。下载仍使用逐文件 ETag/If-Match。",
            "enum": [
              "observed",
              "unknown"
            ],
            "type": "string"
          },
          "contentRevision": {
            "description": "持久保存的有限范围元数据观察状态，不是全目录内容哈希或文件校验值。启动、待持久化或不确定时为 unknown；通知仅提示重新核验。下载仍使用逐文件 ETag/If-Match。",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "dirty": {
            "description": "持久保存的有限范围元数据观察状态，不是全目录内容哈希或文件校验值。启动、待持久化或不确定时为 unknown；通知仅提示重新核验。下载仍使用逐文件 ETag/If-Match。",
            "type": "boolean"
          },
          "generation": {
            "type": "integer"
          },
          "id": {
            "type": "string"
          },
          "lastObservedAt": {
            "description": "上次已持久保存的观察时间，Unix 毫秒；null 表示尚无确认值。",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": [
              "integer",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "protected": {
            "type": "boolean"
          },
          "readOnly": {
            "type": "boolean"
          },
          "slug": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "generation",
          "readOnly",
          "protected",
          "contentEpoch",
          "contentKnowledge",
          "contentRevision",
          "dirty",
          "lastObservedAt"
        ],
        "type": "object"
      },
      "WorkspaceDocumentSendBody": {
        "additionalProperties": false,
        "description": "明确捕获所选文档字节并核验后通过原始协议发送；不是提供程序原子快照，不接受伪造版本或原生路径。",
        "properties": {
          "channelId": {
            "format": "uuid",
            "type": "string"
          },
          "deviceId": {
            "format": "uuid",
            "type": "string"
          },
          "files": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "id": {
                  "format": "uuid",
                  "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
                  "type": "string"
                }
              },
              "required": [
                "id"
              ],
              "type": "object"
            },
            "maxItems": 128,
            "minItems": 1,
            "type": "array"
          },
          "generation": {
            "minimum": 1,
            "type": "integer"
          },
          "instanceId": {
            "format": "uuid",
            "type": "string"
          },
          "localRouteId": {
            "description": "从 devices.read 响应的 localRoutes 选择当前 UUID；省略为自动。失效返回 409 local_route_unavailable，不回退其他网络。重试继承原任务选择。androidNetwork 表示已识别系统 Network 的逐套接字绑定；来源/接口约束不保证绕过 VPN。",
            "format": "uuid",
            "type": "string"
          },
          "requestId": {
            "format": "uuid",
            "type": "string"
          },
          "sourceMode": {
            "const": "documentSnapshot"
          }
        },
        "required": [
          "instanceId",
          "generation",
          "deviceId",
          "requestId",
          "files",
          "sourceMode"
        ],
        "type": "object"
      },
      "WorkspaceFilesystemSendBody": {
        "additionalProperties": false,
        "properties": {
          "channelId": {
            "format": "uuid",
            "type": "string"
          },
          "deviceId": {
            "format": "uuid",
            "type": "string"
          },
          "files": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "id": {
                  "maxLength": 4096,
                  "type": "string"
                },
                "version": {
                  "maxLength": 256,
                  "type": "string"
                }
              },
              "required": [
                "id",
                "version"
              ],
              "type": "object"
            },
            "maxItems": 128,
            "minItems": 1,
            "type": "array"
          },
          "generation": {
            "minimum": 1,
            "type": "integer"
          },
          "instanceId": {
            "format": "uuid",
            "type": "string"
          },
          "localRouteId": {
            "description": "从 devices.read 响应的 localRoutes 选择当前 UUID；省略为自动。失效返回 409 local_route_unavailable，不回退其他网络。重试继承原任务选择。androidNetwork 表示已识别系统 Network 的逐套接字绑定；来源/接口约束不保证绕过 VPN。",
            "format": "uuid",
            "type": "string"
          },
          "requestId": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "instanceId",
          "generation",
          "deviceId",
          "requestId",
          "files"
        ],
        "type": "object"
      },
      "WorkspaceList": {
        "properties": {
          "workspaces": {
            "items": {
              "$ref": "#/components/schemas/Workspace"
            },
            "type": "array"
          }
        },
        "required": [
          "workspaces"
        ],
        "type": "object"
      },
      "WorkspacePasswordBody": {
        "oneOf": [
          {
            "additionalProperties": false,
            "properties": {
              "password": {
                "format": "password",
                "maxLength": 128,
                "minLength": 4,
                "type": "string",
                "writeOnly": true
              }
            },
            "required": [
              "password"
            ],
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "clear": {
                "const": true
              }
            },
            "required": [
              "clear"
            ],
            "type": "object"
          }
        ]
      },
      "WorkspaceSendBody": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/WorkspaceFilesystemSendBody"
          },
          {
            "$ref": "#/components/schemas/WorkspaceDocumentSendBody"
          }
        ]
      },
      "WorkspaceState": {
        "oneOf": [
          {
            "properties": {
              "contentEpoch": {
                "description": "持久保存的有限范围元数据观察状态，不是全目录内容哈希或文件校验值。启动、待持久化或不确定时为 unknown；通知仅提示重新核验。下载仍使用逐文件 ETag/If-Match。",
                "format": "uuid",
                "type": [
                  "string",
                  "null"
                ]
              },
              "contentKnowledge": {
                "description": "持久保存的有限范围元数据观察状态，不是全目录内容哈希或文件校验值。启动、待持久化或不确定时为 unknown；通知仅提示重新核验。下载仍使用逐文件 ETag/If-Match。",
                "enum": [
                  "observed",
                  "unknown"
                ],
                "type": "string"
              },
              "contentRevision": {
                "description": "持久保存的有限范围元数据观察状态，不是全目录内容哈希或文件校验值。启动、待持久化或不确定时为 unknown；通知仅提示重新核验。下载仍使用逐文件 ETag/If-Match。",
                "maximum": 9007199254740991,
                "minimum": 0,
                "type": "integer"
              },
              "dirty": {
                "description": "持久保存的有限范围元数据观察状态，不是全目录内容哈希或文件校验值。启动、待持久化或不确定时为 unknown；通知仅提示重新核验。下载仍使用逐文件 ETag/If-Match。",
                "type": "boolean"
              },
              "entries": {
                "items": {
                  "properties": {
                    "directory": {
                      "type": "boolean"
                    },
                    "id": {
                      "type": "string"
                    },
                    "size": {
                      "type": "integer"
                    },
                    "version": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "id",
                    "size",
                    "directory",
                    "version"
                  ],
                  "type": "object"
                },
                "maxItems": 64,
                "type": "array"
              },
              "generation": {
                "type": "integer"
              },
              "lastObservedAt": {
                "description": "上次已持久保存的观察时间，Unix 毫秒；null 表示尚无确认值。",
                "maximum": 9007199254740991,
                "minimum": 0,
                "type": [
                  "integer",
                  "null"
                ]
              },
              "missing": {
                "items": {
                  "type": "string"
                },
                "maxItems": 64,
                "type": "array"
              },
              "path": {
                "type": "string"
              },
              "stamp": {
                "type": "string"
              }
            },
            "required": [
              "generation",
              "path",
              "stamp",
              "entries",
              "missing",
              "contentEpoch",
              "contentKnowledge",
              "contentRevision",
              "dirty",
              "lastObservedAt"
            ],
            "type": "object"
          },
          {
            "description": "文档提供程序当前目录的短期变化提示，不是内容版本或增量清单。",
            "properties": {
              "contentEpoch": {
                "description": "持久保存的有限范围元数据观察状态，不是全目录内容哈希或文件校验值。启动、待持久化或不确定时为 unknown；通知仅提示重新核验。下载仍使用逐文件 ETag/If-Match。",
                "format": "uuid",
                "type": [
                  "string",
                  "null"
                ]
              },
              "contentKnowledge": {
                "description": "持久保存的有限范围元数据观察状态，不是全目录内容哈希或文件校验值。启动、待持久化或不确定时为 unknown；通知仅提示重新核验。下载仍使用逐文件 ETag/If-Match。",
                "enum": [
                  "observed",
                  "unknown"
                ],
                "type": "string"
              },
              "contentRevision": {
                "description": "持久保存的有限范围元数据观察状态，不是全目录内容哈希或文件校验值。启动、待持久化或不确定时为 unknown；通知仅提示重新核验。下载仍使用逐文件 ETag/If-Match。",
                "maximum": 9007199254740991,
                "minimum": 0,
                "type": "integer"
              },
              "dirty": {
                "description": "持久保存的有限范围元数据观察状态，不是全目录内容哈希或文件校验值。启动、待持久化或不确定时为 unknown；通知仅提示重新核验。下载仍使用逐文件 ETag/If-Match。",
                "type": "boolean"
              },
              "generation": {
                "type": "integer"
              },
              "lastObservedAt": {
                "description": "上次已持久保存的观察时间，Unix 毫秒；null 表示尚无确认值。",
                "maximum": 9007199254740991,
                "minimum": 0,
                "type": [
                  "integer",
                  "null"
                ]
              },
              "observing": {
                "type": "boolean"
              },
              "path": {
                "type": "string"
              },
              "refreshFromStart": {
                "const": true
              },
              "stamp": {
                "type": "string"
              },
              "watchId": {
                "format": "uuid",
                "type": "string"
              }
            },
            "required": [
              "generation",
              "path",
              "refreshFromStart",
              "watchId",
              "stamp",
              "observing",
              "contentEpoch",
              "contentKnowledge",
              "contentRevision",
              "dirty",
              "lastObservedAt"
            ],
            "type": "object"
          }
        ]
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "bearerFormat": "ls1 key",
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "description": "按权限提供读取、密钥上传、工作区管理、宿主设置与缓存、密钥及原生任务控制。匿名授权独立且不授予写入权限；LocalSend 原始传送协议保持不变。",
    "title": "LegnaSend 集成 API",
    "version": "1.0.0"
  },
  "openapi": "3.1.0",
  "paths": {
    "/approved-workspace-sources": {
      "get": {
        "description": "仅有效密钥 workspaces.manage 可用，且限授权工作区；宿主持久化后才确认。接手前撤销会取消；宿主接手后即使断线仍可完成。outcome_unknown 表示结果未知，先读取清单核对代次，请勿自动重试。destroy 仅删除共享配置，不删除本地文件。",
        "operationId": "listApprovedWorkspaceSources",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApprovedSourceList"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "列出本机已批准的来源引用，不显示路径",
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "workspaces.manage"
      }
    },
    "/cache": {
      "get": {
        "description": "须明确密钥权限及全局 * 授权。缓存仅处理已登记且核验身份的非活动暂存，未确认或使用中的内容保留；不接受本地路径。设置只允许契约列出的字段，不返回秘密、路径或密钥。变更接手后超时须重新查询，不自动重试。",
        "operationId": "inspectCache",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CacheReport"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "盘点受管原生接收缓存，不删除文件",
        "x-legnasend-key-only": true,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "cache.read",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/cache/cleanup": {
      "post": {
        "description": "须明确密钥权限及全局 * 授权。缓存仅处理已登记且核验身份的非活动暂存，未确认或使用中的内容保留；不接受本地路径。设置只允许契约列出的字段，不返回秘密、路径或密钥。变更接手后超时须重新查询，不自动重试。",
        "operationId": "cleanupCache",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CacheReport"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "清理已核验身份的非活动接收缓存",
        "x-legnasend-key-only": true,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "cache.clean",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/capabilities": {
      "get": {
        "operationId": "getCapabilities",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Capabilities"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "当前已实现能力",
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "service.read"
      }
    },
    "/devices": {
      "get": {
        "description": "需要明确的专用密钥权限及全局 * 授权；匿名、工作区密码及单工作区密钥均无效。设备与通道 ID 来自本机发现，文件只能来自本机当前选择；拒绝任意路径或主机。任务仅对创建它的密钥可见。ID、选择版本及幂等回执在应用重启后失效。send/retry 必须带 requestId；重复相同请求返回原任务，相同 ID 不同参数返回 409。重试是原始协议的整文件重传，并非字节续传。接手前撤销会取消；接手后可能继续，outcome_unknown 时以相同 requestId 核对，不要使用新 ID 重送。scan/send/retry 的 202 仅表示接手，不代表发现或传送成功。",
        "operationId": "listDevices",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeviceList"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "列出已发现设备",
        "x-legnasend-key-only": true,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "devices.read",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/devices/scan": {
      "post": {
        "description": "需要明确的专用密钥权限及全局 * 授权；匿名、工作区密码及单工作区密钥均无效。设备与通道 ID 来自本机发现，文件只能来自本机当前选择；拒绝任意路径或主机。任务仅对创建它的密钥可见。ID、选择版本及幂等回执在应用重启后失效。send/retry 必须带 requestId；重复相同请求返回原任务，相同 ID 不同参数返回 409。重试是原始协议的整文件重传，并非字节续传。接手前撤销会取消；接手后可能继续，outcome_unknown 时以相同 requestId 核对，不要使用新 ID 重送。scan/send/retry 的 202 仅表示接手，不代表发现或传送成功。",
        "operationId": "scanDevices",
        "parameters": [],
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScanResult"
                }
              }
            },
            "description": "已接手，尚未完成",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "发起设备扫描",
        "x-legnasend-key-only": true,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "devices.scan",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/devices/{deviceId}": {
      "get": {
        "description": "需要明确的专用密钥权限及全局 * 授权；匿名、工作区密码及单工作区密钥均无效。设备与通道 ID 来自本机发现，文件只能来自本机当前选择；拒绝任意路径或主机。任务仅对创建它的密钥可见。ID、选择版本及幂等回执在应用重启后失效。send/retry 必须带 requestId；重复相同请求返回原任务，相同 ID 不同参数返回 409。重试是原始协议的整文件重传，并非字节续传。接手前撤销会取消；接手后可能继续，outcome_unknown 时以相同 requestId 核对，不要使用新 ID 重送。scan/send/retry 的 202 仅表示接手，不代表发现或传送成功。",
        "operationId": "getDevice",
        "parameters": [
          {
            "in": "path",
            "name": "deviceId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeviceResult"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "读取设备及可用通道",
        "x-legnasend-key-only": true,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "devices.read",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/keys": {
      "get": {
        "description": "须有效密钥明确授予 keys.manage 与 *。不可创建超出自身权限或到期时间的密钥，不可管理自身。修改须版本与 requestId；同请求重放仅返回回执，不再返回秘密。未知结果以原 requestId 查询，不自动创建新密钥。",
        "operationId": "listKeys",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KeyList"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "列出授权范围内密钥元数据",
        "x-legnasend-key-only": true,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "keys.manage",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/keys/create": {
      "post": {
        "description": "须有效密钥明确授予 keys.manage 与 *。不可创建超出自身权限或到期时间的密钥，不可管理自身。修改须版本与 requestId；同请求重放仅返回回执，不再返回秘密。未知结果以原 requestId 查询，不自动创建新密钥。",
        "operationId": "createKey",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/KeyCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KeyResult"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KeyResult"
                }
              }
            },
            "description": "密钥已持久化并应用；秘密仅交付一次",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "创建不超出自身权限的密钥，秘密只返回一次",
        "x-legnasend-key-only": true,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "keys.manage",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/keys/requests/{requestId}": {
      "get": {
        "description": "须有效密钥明确授予 keys.manage 与 *。不可创建超出自身权限或到期时间的密钥，不可管理自身。修改须版本与 requestId；同请求重放仅返回回执，不再返回秘密。未知结果以原 requestId 查询，不自动创建新密钥。",
        "operationId": "getKeyReceipt",
        "parameters": [
          {
            "in": "path",
            "name": "requestId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KeyResult"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "查询密钥操作持久回执",
        "x-legnasend-key-only": true,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "keys.manage",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/keys/{keyId}/manage": {
      "post": {
        "description": "须有效密钥明确授予 keys.manage 与 *。不可创建超出自身权限或到期时间的密钥，不可管理自身。修改须版本与 requestId；同请求重放仅返回回执，不再返回秘密。未知结果以原 requestId 查询，不自动创建新密钥。",
        "operationId": "manageKey",
        "parameters": [
          {
            "in": "path",
            "name": "keyId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/KeyManage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KeyResult"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥生命周期、授权、版本或结果状态错误；检查稳定错误代码，不含秘密或本地路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "暂停、恢复或撤销其他密钥",
        "x-legnasend-key-only": true,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "keys.manage",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/managed-workspaces": {
      "get": {
        "description": "仅有效密钥 workspaces.manage 可用，且限授权工作区；宿主持久化后才确认。接手前撤销会取消；宿主接手后即使断线仍可完成。outcome_unknown 表示结果未知，先读取清单核对代次，请勿自动重试。destroy 仅删除共享配置，不删除本地文件。",
        "operationId": "listManagedWorkspaces",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagedWorkspaceList"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "列出已授权的持久工作区（包含已停用项目）",
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "workspaces.manage"
      }
    },
    "/managed-workspaces/create": {
      "post": {
        "description": "仅有效密钥 workspaces.manage 可用，且限授权工作区；宿主持久化后才确认。接手前撤销会取消；宿主接手后即使断线仍可完成。outcome_unknown 表示结果未知，先读取清单核对代次，请勿自动重试。destroy 仅删除共享配置，不删除本地文件。",
        "operationId": "createWorkspace",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWorkspaceBody"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "从已批准来源创建已关闭的工作区",
        "x-legnasend-body-only": [
          "sourceId",
          "password",
          "clear",
          "slug"
        ],
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-no-retry": true,
        "x-legnasend-scope": "workspaces.manage"
      }
    },
    "/native-tasks": {
      "get": {
        "description": "须有效密钥明确授予 nativeTasks.read 或 nativeTasks.control 与 *。本接口读取全部本机原生任务，不限此密钥创建的发送记录。控制必须使用刚读取的 epoch、id、version；变更后须重新读取，禁止自动重试。接受沿用本机目的地与文件名；remove 仅移除终态记录，不删文件。不提供暂停与续传。",
        "operationId": "listNativeTasks",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NativeTaskList"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "读取全部原生收发任务及速度",
        "x-legnasend-key-only": true,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "nativeTasks.read",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/native-tasks/source-end": {
      "get": {
        "description": "须有效密钥、对应 nativeTasks.read/control 与 *。仅提供脱敏通知，不暴露路径或清理凭证。重试使用最新 version 与固定 requestId；相同请求可核对未知结果，变更内容须新 ID。accepted 仅表示已排程，不代表远端文件已清理。离线、共享来源、活动接收及未知结果保持独立状态；已发布文件不删除。 可选 cleanup 仅在接收端确认的终态中提供回执编号、实际移除临时文件数与逻辑字节数；缺失表示没有数量回执，不表示移除零文件。该字节数不是实际释放磁盘空间的测量值。",
        "operationId": "listSourceEndNotices",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SourceEndNoticeList"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "读取来源结束通知状态",
        "x-legnasend-key-only": true,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "nativeTasks.read",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/native-tasks/source-end/{noticeId}/retry": {
      "post": {
        "description": "须有效密钥、对应 nativeTasks.read/control 与 *。仅提供脱敏通知，不暴露路径或清理凭证。重试使用最新 version 与固定 requestId；相同请求可核对未知结果，变更内容须新 ID。accepted 仅表示已排程，不代表远端文件已清理。离线、共享来源、活动接收及未知结果保持独立状态；已发布文件不删除。 可选 cleanup 仅在接收端确认的终态中提供回执编号、实际移除临时文件数与逻辑字节数；缺失表示没有数量回执，不表示移除零文件。该字节数不是实际释放磁盘空间的测量值。",
        "operationId": "retrySourceEndNotice",
        "parameters": [
          {
            "in": "path",
            "name": "noticeId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SourceEndRetry"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SourceEndRetryResult"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "重试一项来源结束通知",
        "x-legnasend-key-only": true,
        "x-legnasend-max-body-bytes": 8192,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "nativeTasks.control",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/native-tasks/{taskId}/control": {
      "post": {
        "description": "须有效密钥明确授予 nativeTasks.read 或 nativeTasks.control 与 *。本接口读取全部本机原生任务，不限此密钥创建的发送记录。控制必须使用刚读取的 epoch、id、version；变更后须重新读取，禁止自动重试。接受沿用本机目的地与文件名；remove 仅移除终态记录，不删文件。不提供暂停与续传。",
        "operationId": "controlNativeTask",
        "parameters": [
          {
            "in": "path",
            "name": "taskId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NativeTaskControl"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NativeTaskControlResult"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "原生任务授权、版本或派发状态错误；检查稳定代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "按版本取消、接受、拒绝或移除原生任务",
        "x-legnasend-key-only": true,
        "x-legnasend-max-body-bytes": 8192,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-no-retry": true,
        "x-legnasend-scope": "nativeTasks.control",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/openapi.json": {
      "get": {
        "operationId": "getOpenApi",
        "parameters": [
          {
            "in": "query",
            "name": "lang",
            "required": false,
            "schema": {
              "default": "en",
              "enum": [
                "en",
                "zh-CN",
                "zh-TW",
                "zh-HK"
              ],
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "当前版本的接口契约",
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "service.read"
      }
    },
    "/requests": {
      "get": {
        "operationId": "listRequests",
        "parameters": [
          {
            "in": "query",
            "name": "after",
            "required": false,
            "schema": {
              "default": 0,
              "minimum": 0,
              "type": "integer",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "x-legnasend-max-utf8-bytes": 4096
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RequestPage"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "有界且已脱敏的请求记录",
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "requests.read"
      }
    },
    "/requests/clear": {
      "post": {
        "description": "须有效密钥明确授予 requests.manage 与 *。只清除不超过已读水位的记录；实例与代次须一致。序号、实例、限流及活动传输不重置，保留清除标记与稍后完成的记录。",
        "operationId": "clearRequests",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ClearRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ClearResult"
                }
              }
            },
            "description": "Cleared observed records only",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "description": "history_changed：历史实例或代次已改变，重新读取后再操作",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "按实例与水位清除请求历史",
        "x-legnasend-key-only": true,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "requests.manage",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/send-selection": {
      "get": {
        "description": "需要明确的专用密钥权限及全局 * 授权；匿名、工作区密码及单工作区密钥均无效。设备与通道 ID 来自本机发现，文件只能来自本机当前选择；拒绝任意路径或主机。任务仅对创建它的密钥可见。ID、选择版本及幂等回执在应用重启后失效。send/retry 必须带 requestId；重复相同请求返回原任务，相同 ID 不同参数返回 409。重试是原始协议的整文件重传，并非字节续传。接手前撤销会取消；接手后可能继续，outcome_unknown 时以相同 requestId 核对，不要使用新 ID 重送。scan/send/retry 的 202 仅表示接手，不代表发现或传送成功。",
        "operationId": "getSendSelection",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SendSelection"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "读取本机选中的发送文件摘要",
        "x-legnasend-key-only": true,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "transfers.read",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/settings": {
      "get": {
        "description": "须明确密钥权限及全局 * 授权。缓存仅处理已登记且核验身份的非活动暂存，未确认或使用中的内容保留；不接受本地路径。设置只允许契约列出的字段，不返回秘密、路径或密钥。变更接手后超时须重新查询，不自动重试。",
        "operationId": "readSettings",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HostSettings"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "读取不含秘密的应用设置",
        "x-legnasend-key-only": true,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "settings.read",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/settings/update": {
      "post": {
        "description": "须明确密钥权限及全局 * 授权。缓存仅处理已登记且核验身份的非活动暂存，未确认或使用中的内容保留；不接受本地路径。设置只允许契约列出的字段，不返回秘密、路径或密钥。变更接手后超时须重新查询，不自动重试。",
        "operationId": "updateSettings",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "allOf": [
                  {
                    "else": {
                      "properties": {
                        "value": {
                          "oneOf": [
                            {
                              "maxLength": 120,
                              "type": "string"
                            },
                            {
                              "type": "boolean"
                            }
                          ]
                        }
                      }
                    },
                    "if": {
                      "properties": {
                        "field": {
                          "const": "receiveCacheRetentionDays"
                        }
                      },
                      "required": [
                        "field"
                      ]
                    },
                    "then": {
                      "properties": {
                        "value": {
                          "description": "原生接收崩溃残留保留期：-2 为 1 小时（默认），-1 等待本地手动清理，0 在下次维护时不延迟清理，1–3650 为天数；更改策略本身不会执行清理。只处理已登记且非活动的原生残留；不授予立即清理覆盖、不影响正常取消，也不代表可断点续传。",
                          "maximum": 3650,
                          "minimum": -2,
                          "type": "integer"
                        }
                      }
                    }
                  }
                ],
                "properties": {
                  "field": {
                    "enum": [
                      "alias",
                      "theme",
                      "locale",
                      "enableAnimations",
                      "autoFinish",
                      "createChecksums",
                      "verifyChecksums",
                      "receiveCacheRetentionDays"
                    ],
                    "type": "string"
                  },
                  "value": {
                    "oneOf": [
                      {
                        "maxLength": 120,
                        "type": "string"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "description": "原生接收崩溃残留保留期：-2 为 1 小时（默认），-1 等待本地手动清理，0 在下次维护时不延迟清理，1–3650 为天数；更改策略本身不会执行清理。只处理已登记且非活动的原生残留；不授予立即清理覆盖、不影响正常取消，也不代表可断点续传。",
                        "maximum": 3650,
                        "minimum": -2,
                        "type": "integer"
                      }
                    ]
                  },
                  "version": {
                    "pattern": "^[a-f0-9]{64}$",
                    "type": "string"
                  }
                },
                "required": [
                  "version",
                  "field",
                  "value"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HostSettings"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "settings_busy 表示本地设置正在变更；settings_changed 表示版本已变更。重新读取状态，不自动重试。",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "host_operation_failed：持久化、原生应用或恢复失败；重新读取 receiveCacheRetention 的实际状态。",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "宿主设置、缓存、授权或结果状态错误；检查稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "按版本核验修改一项受支持设置",
        "x-legnasend-key-only": true,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "settings.write",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/status": {
      "get": {
        "operationId": "getStatus",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Status"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "服务状态与非敏感配额",
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "service.read"
      }
    },
    "/transfers": {
      "get": {
        "description": "需要明确的专用密钥权限及全局 * 授权；匿名、工作区密码及单工作区密钥均无效。设备与通道 ID 来自本机发现，文件只能来自本机当前选择；拒绝任意路径或主机。任务仅对创建它的密钥可见。ID、选择版本及幂等回执在应用重启后失效。send/retry 必须带 requestId；重复相同请求返回原任务，相同 ID 不同参数返回 409。重试是原始协议的整文件重传，并非字节续传。接手前撤销会取消；接手后可能继续，outcome_unknown 时以相同 requestId 核对，不要使用新 ID 重送。scan/send/retry 的 202 仅表示接手，不代表发现或传送成功。",
        "operationId": "listTransfers",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TransferList"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "列出此密钥的发送任务",
        "x-legnasend-key-only": true,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "transfers.read",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/transfers/send": {
      "post": {
        "description": "需要明确的专用密钥权限及全局 * 授权；匿名、工作区密码及单工作区密钥均无效。设备与通道 ID 来自本机发现，文件只能来自本机当前选择；拒绝任意路径或主机。任务仅对创建它的密钥可见。ID、选择版本及幂等回执在应用重启后失效。send/retry 必须带 requestId；重复相同请求返回原任务，相同 ID 不同参数返回 409。重试是原始协议的整文件重传，并非字节续传。接手前撤销会取消；接手后可能继续，outcome_unknown 时以相同 requestId 核对，不要使用新 ID 重送。scan/send/retry 的 202 仅表示接手，不代表发现或传送成功。",
        "operationId": "sendSelection",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SendTransferBody"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TransferReceipt"
                }
              }
            },
            "description": "已接手，尚未完成",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "将当前选择发送到指定设备",
        "x-legnasend-key-only": true,
        "x-legnasend-max-body-bytes": 8192,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "transfers.send",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/transfers/{transferId}": {
      "get": {
        "description": "需要明确的专用密钥权限及全局 * 授权；匿名、工作区密码及单工作区密钥均无效。设备与通道 ID 来自本机发现，文件只能来自本机当前选择；拒绝任意路径或主机。任务仅对创建它的密钥可见。ID、选择版本及幂等回执在应用重启后失效。send/retry 必须带 requestId；重复相同请求返回原任务，相同 ID 不同参数返回 409。重试是原始协议的整文件重传，并非字节续传。接手前撤销会取消；接手后可能继续，outcome_unknown 时以相同 requestId 核对，不要使用新 ID 重送。scan/send/retry 的 202 仅表示接手，不代表发现或传送成功。",
        "operationId": "getTransfer",
        "parameters": [
          {
            "in": "path",
            "name": "transferId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TransferResult"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "读取发送任务进度",
        "x-legnasend-key-only": true,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "transfers.read",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/transfers/{transferId}/cancel": {
      "post": {
        "description": "需要明确的专用密钥权限及全局 * 授权；匿名、工作区密码及单工作区密钥均无效。设备与通道 ID 来自本机发现，文件只能来自本机当前选择；拒绝任意路径或主机。任务仅对创建它的密钥可见。ID、选择版本及幂等回执在应用重启后失效。send/retry 必须带 requestId；重复相同请求返回原任务，相同 ID 不同参数返回 409。重试是原始协议的整文件重传，并非字节续传。接手前撤销会取消；接手后可能继续，outcome_unknown 时以相同 requestId 核对，不要使用新 ID 重送。scan/send/retry 的 202 仅表示接手，不代表发现或传送成功。",
        "operationId": "cancelTransfer",
        "parameters": [
          {
            "in": "path",
            "name": "transferId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TransferResult"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "取消发送任务",
        "x-legnasend-key-only": true,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "transfers.control",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/transfers/{transferId}/remove": {
      "post": {
        "description": "需要明确的专用密钥权限及全局 * 授权；匿名、工作区密码及单工作区密钥均无效。设备与通道 ID 来自本机发现，文件只能来自本机当前选择；拒绝任意路径或主机。任务仅对创建它的密钥可见。ID、选择版本及幂等回执在应用重启后失效。send/retry 必须带 requestId；重复相同请求返回原任务，相同 ID 不同参数返回 409。重试是原始协议的整文件重传，并非字节续传。接手前撤销会取消；接手后可能继续，outcome_unknown 时以相同 requestId 核对，不要使用新 ID 重送。scan/send/retry 的 202 仅表示接手，不代表发现或传送成功。",
        "operationId": "removeTransfer",
        "parameters": [
          {
            "in": "path",
            "name": "transferId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TransferRemoval"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "移除终止任务记录",
        "x-legnasend-key-only": true,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "transfers.control",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/transfers/{transferId}/retry": {
      "post": {
        "description": "需要明确的专用密钥权限及全局 * 授权；匿名、工作区密码及单工作区密钥均无效。设备与通道 ID 来自本机发现，文件只能来自本机当前选择；拒绝任意路径或主机。任务仅对创建它的密钥可见。ID、选择版本及幂等回执在应用重启后失效。send/retry 必须带 requestId；重复相同请求返回原任务，相同 ID 不同参数返回 409。重试是原始协议的整文件重传，并非字节续传。接手前撤销会取消；接手后可能继续，outcome_unknown 时以相同 requestId 核对，不要使用新 ID 重送。scan/send/retry 的 202 仅表示接手，不代表发现或传送成功。 重试同时要求 transfers.control 和 transfers.send 权限，移除发送权限即阻止新传送。",
        "operationId": "retryTransfer",
        "parameters": [
          {
            "in": "path",
            "name": "transferId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RetryTransferBody"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TransferReceipt"
                }
              }
            },
            "description": "已接手，尚未完成",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "重试已终止任务；完整重传原选择内容，包括已完成文件",
        "x-legnasend-additional-scopes": [
          "transfers.send"
        ],
        "x-legnasend-key-only": true,
        "x-legnasend-max-body-bytes": 8192,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "transfers.control",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/workspaces": {
      "get": {
        "operationId": "listWorkspaces",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkspaceList"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "列出已授权工作区",
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "workspaces.read"
      }
    },
    "/workspaces/{workspaceId}": {
      "get": {
        "operationId": "getWorkspace",
        "parameters": [
          {
            "in": "path",
            "name": "workspaceId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Workspace"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "读取工作区描述",
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "workspaces.read"
      }
    },
    "/workspaces/{workspaceId}/archive": {
      "get": {
        "operationId": "downloadWorkspaceArchive",
        "parameters": [
          {
            "in": "path",
            "name": "workspaceId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "generation",
            "required": true,
            "schema": {
              "minimum": 1,
              "type": "integer",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "path",
            "required": false,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "ids",
            "required": false,
            "schema": {
              "description": "可省略；当前 path 下 1–128 个不重复直接子项 ID 的 JSON 数组，不是文件路径。",
              "maxLength": 8192,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 8192
            }
          },
          {
            "in": "query",
            "name": "selection",
            "required": false,
            "schema": {
              "description": "同一授权创建的 ZIP 票据，不与 path 或 ids 同时提供，不代替 Authorization。",
              "format": "uuid",
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/zip": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": "逐文件流式 ZIP，不镜像来源、不提供断点续传",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "流式下载工作区或选中项目的 ZIP",
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "files.read"
      },
      "head": {
        "operationId": "headWorkspaceArchive",
        "parameters": [
          {
            "in": "path",
            "name": "workspaceId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "generation",
            "required": true,
            "schema": {
              "minimum": 1,
              "type": "integer",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "path",
            "required": false,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "ids",
            "required": false,
            "schema": {
              "description": "可省略；当前 path 下 1–128 个不重复直接子项 ID 的 JSON 数组，不是文件路径。",
              "maxLength": 8192,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 8192
            }
          },
          {
            "in": "query",
            "name": "selection",
            "required": false,
            "schema": {
              "description": "同一授权创建的 ZIP 票据，不与 path 或 ids 同时提供，不代替 Authorization。",
              "format": "uuid",
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          }
        ],
        "responses": {
          "200": {
            "description": "逐文件流式 ZIP，不镜像来源、不提供断点续传",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "流式下载工作区或选中项目的 ZIP",
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "files.read"
      }
    },
    "/workspaces/{workspaceId}/cancel-archive": {
      "post": {
        "description": "须 files.read 与目标工作区授权。最多 20,000 个不重复直接子项 ID、2 MiB JSON；票据仅保存选择信息，不缓存 ZIP。120 秒绝对期限仅限制新下载准入，不中断已开始的归档，同所有者与调用者最多四张，全局 64 张；取消停止该票据的活动流。丢失创建响应时不要自动重试。",
        "operationId": "cancelWorkspaceArchive",
        "parameters": [
          {
            "in": "path",
            "name": "workspaceId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "generation",
            "required": true,
            "schema": {
              "minimum": 1,
              "type": "integer",
              "x-legnasend-max-utf8-bytes": 4096
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ArchiveSelectionCancel"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "cancelled": {
                      "const": true
                    }
                  },
                  "required": [
                    "cancelled"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "撤销精确 ZIP 票据及其活动流",
        "x-legnasend-max-body-bytes": 1024,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "files.read"
      }
    },
    "/workspaces/{workspaceId}/close-preview": {
      "post": {
        "description": "须 files.read 与目标工作区授权。仅文档提供程序；最多八个描述符租约，120 秒闲置过期。HEAD/读取续期；关闭、换代或撤权终止。固定同一 FD，不镜像来源；ETag 是租约与元数据而非内容摘要。",
        "operationId": "closeDocumentPreview",
        "parameters": [
          {
            "in": "path",
            "name": "workspaceId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "generation",
            "required": true,
            "schema": {
              "minimum": 1,
              "type": "integer",
              "x-legnasend-max-utf8-bytes": 4096
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "lease": {
                    "format": "uuid",
                    "type": "string"
                  }
                },
                "required": [
                  "lease"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "closed": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "closed"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "关闭此授权的文档预览租约",
        "x-legnasend-max-body-bytes": 1024,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "files.read"
      }
    },
    "/workspaces/{workspaceId}/files": {
      "get": {
        "operationId": "listFiles",
        "parameters": [
          {
            "in": "path",
            "name": "workspaceId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "generation",
            "required": true,
            "schema": {
              "minimum": 1,
              "type": "integer",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "path",
            "required": false,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "filter",
            "required": false,
            "schema": {
              "default": "",
              "maxLength": 256,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "anchor",
            "required": false,
            "schema": {
              "description": "当前目录的文件 ID；仅首个请求使用，后续沿用游标。有界定位位置，不是偏移或访问凭证。",
              "maxLength": 8192,
              "pattern": "^[A-Za-z0-9_-]+$",
              "type": "string",
              "x-legnasend-max-utf8-bytes": 8192
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FilePage"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "分页读取文件清单",
        "x-legnasend-max-query-bytes": 24576,
        "x-legnasend-scope": "files.read"
      }
    },
    "/workspaces/{workspaceId}/files/{fileId}/content": {
      "get": {
        "operationId": "getContent",
        "parameters": [
          {
            "in": "path",
            "name": "workspaceId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "path",
            "name": "fileId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "generation",
            "required": true,
            "schema": {
              "minimum": 1,
              "type": "integer",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "preview",
            "required": false,
            "schema": {
              "enum": [
                "0",
                "1"
              ],
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "version",
            "required": false,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "lease",
            "required": false,
            "schema": {
              "description": "同一授权创建的预览租约，不是下载续传版本。",
              "format": "uuid",
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "header",
            "name": "Range",
            "required": false,
            "schema": {
              "maxLength": 1024,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 1024
            }
          },
          {
            "in": "header",
            "name": "If-Match",
            "required": false,
            "schema": {
              "maxLength": 1024,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 1024
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "*/*": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              },
              "application/octet-stream": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": "Original file",
            "headers": {
              "Accept-Ranges": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Disposition": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Length": {
                "schema": {
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "ETag": {
                "schema": {
                  "type": "string"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "206": {
            "content": {
              "*/*": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              },
              "application/octet-stream": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": "请求的字节范围",
            "headers": {
              "Accept-Ranges": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Disposition": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Length": {
                "schema": {
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "Content-Range": {
                "schema": {
                  "type": "string"
                }
              },
              "ETag": {
                "schema": {
                  "type": "string"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "416": {
            "description": "范围超出文件长度",
            "headers": {
              "Content-Range": {
                "schema": {
                  "type": "string"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "原始文件与字节范围",
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "files.read"
      },
      "head": {
        "operationId": "headContent",
        "parameters": [
          {
            "in": "path",
            "name": "workspaceId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "path",
            "name": "fileId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "generation",
            "required": true,
            "schema": {
              "minimum": 1,
              "type": "integer",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "preview",
            "required": false,
            "schema": {
              "enum": [
                "0",
                "1"
              ],
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "version",
            "required": false,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "lease",
            "required": false,
            "schema": {
              "description": "同一授权创建的预览租约，不是下载续传版本。",
              "format": "uuid",
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "header",
            "name": "Range",
            "required": false,
            "schema": {
              "maxLength": 1024,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 1024
            }
          },
          {
            "in": "header",
            "name": "If-Match",
            "required": false,
            "schema": {
              "maxLength": 1024,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 1024
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Original file",
            "headers": {
              "Accept-Ranges": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Disposition": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Length": {
                "schema": {
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "ETag": {
                "schema": {
                  "type": "string"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "206": {
            "description": "请求的字节范围",
            "headers": {
              "Accept-Ranges": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Disposition": {
                "schema": {
                  "type": "string"
                }
              },
              "Content-Length": {
                "schema": {
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "Content-Range": {
                "schema": {
                  "type": "string"
                }
              },
              "ETag": {
                "schema": {
                  "type": "string"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "416": {
            "description": "范围超出文件长度",
            "headers": {
              "Content-Range": {
                "schema": {
                  "type": "string"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "原始文件与字节范围",
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "files.read"
      }
    },
    "/workspaces/{workspaceId}/manage": {
      "post": {
        "description": "仅有效密钥 workspaces.manage 可用，且限授权工作区；宿主持久化后才确认。接手前撤销会取消；宿主接手后即使断线仍可完成。outcome_unknown 表示结果未知，先读取清单核对代次，请勿自动重试。destroy 仅删除共享配置，不删除本地文件。",
        "operationId": "manageWorkspace",
        "parameters": [
          {
            "in": "path",
            "name": "workspaceId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "generation",
            "required": true,
            "schema": {
              "minimum": 1,
              "type": "integer",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "action",
            "required": true,
            "schema": {
              "enum": [
                "update",
                "enable",
                "disable",
                "validate",
                "destroy",
                "configure",
                "password"
              ],
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "name",
            "required": false,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "visible",
            "required": false,
            "schema": {
              "type": "boolean",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "allowUpload",
            "required": false,
            "schema": {
              "type": "boolean",
              "x-legnasend-max-utf8-bytes": 4096
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/ConfigureWorkspaceBody"
                  },
                  {
                    "$ref": "#/components/schemas/WorkspacePasswordBody"
                  }
                ]
              }
            }
          },
          "required": false
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManagementResult"
                }
              }
            },
            "description": "宿主、授权、代次或结果状态；参阅稳定错误代码",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "按代次比较更新、启停、验证或销毁工作区设置",
        "x-legnasend-body-only": [
          "sourceId",
          "password",
          "clear",
          "slug"
        ],
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-no-retry": true,
        "x-legnasend-scope": "workspaces.manage"
      }
    },
    "/workspaces/{workspaceId}/prepare-archive": {
      "post": {
        "description": "须 files.read 与目标工作区授权。最多 20,000 个不重复直接子项 ID、2 MiB JSON；票据仅保存选择信息，不缓存 ZIP。120 秒绝对期限仅限制新下载准入，不中断已开始的归档，同所有者与调用者最多四张，全局 64 张；取消停止该票据的活动流。丢失创建响应时不要自动重试。",
        "operationId": "prepareWorkspaceArchive",
        "parameters": [
          {
            "in": "path",
            "name": "workspaceId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "generation",
            "required": true,
            "schema": {
              "minimum": 1,
              "type": "integer",
              "x-legnasend-max-utf8-bytes": 4096
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ArchiveSelectionPrepare"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ArchiveSelectionTicket"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "为大量选中项 ZIP 创建短期票据",
        "x-legnasend-max-body-bytes": 2097152,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "files.read"
      }
    },
    "/workspaces/{workspaceId}/prepare-preview": {
      "post": {
        "description": "须 files.read 与目标工作区授权。仅文档提供程序；最多八个描述符租约，120 秒闲置过期。HEAD/读取续期；关闭、换代或撤权终止。固定同一 FD，不镜像来源；ETag 是租约与元数据而非内容摘要。",
        "operationId": "prepareDocumentPreview",
        "parameters": [
          {
            "in": "path",
            "name": "workspaceId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "generation",
            "required": true,
            "schema": {
              "minimum": 1,
              "type": "integer",
              "x-legnasend-max-utf8-bytes": 4096
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "type": "string"
                  }
                },
                "required": [
                  "id"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DocumentPreviewLease"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "创建文档提供程序只读预览租约",
        "x-legnasend-max-body-bytes": 1024,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "files.read"
      }
    },
    "/workspaces/{workspaceId}/send": {
      "post": {
        "description": "须有效密钥 transfers.send 和 files.read 及全局 * 授权。仅接受当前服务 instanceId、工作区 generation、最多 128 个清单 fileId 与完整带引号的 ETag version，以及已发现设备／通道 ID。拒绝任意路径、网址、IP 或隐式文件夹递归。宿主先验证并快照来源，再以原始 LocalSend 协议入队；不改变 UI 选择。202 仅表示已入队；相同 requestId 重放核对原回执，禁止结果未知时换 ID。",
        "operationId": "sendWorkspaceFiles",
        "parameters": [
          {
            "in": "path",
            "name": "workspaceId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WorkspaceSendBody"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TransferReceipt"
                }
              }
            },
            "description": "已接手，尚未完成",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定的授权、校验、宿主或任务状态错误",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "将工作区内指定版本文件发送至已发现设备",
        "x-legnasend-additional-scopes": [
          "files.read"
        ],
        "x-legnasend-key-only": true,
        "x-legnasend-max-body-bytes": 65536,
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "transfers.send",
        "x-legnasend-workspace-grant": "*"
      }
    },
    "/workspaces/{workspaceId}/state": {
      "get": {
        "operationId": "getWorkspaceState",
        "parameters": [
          {
            "in": "path",
            "name": "workspaceId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "generation",
            "required": true,
            "schema": {
              "minimum": 1,
              "type": "integer",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "path",
            "required": false,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "ids",
            "required": false,
            "schema": {
              "description": "当前目录内最多 64 个标准 ASCII 文件 ID，以逗号分隔，合计最多 8192 字节；不是本地路径或网址",
              "maxLength": 8192,
              "pattern": "^(?:[A-Za-z0-9_-]+(?:,[A-Za-z0-9_-]+){0,63})?$",
              "type": "string",
              "x-legnasend-max-utf8-bytes": 8192
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkspaceState"
                }
              }
            },
            "description": "成功",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "核验目录状态与最多 64 个可见文件的版本",
        "x-legnasend-max-query-bytes": 24576,
        "x-legnasend-scope": "files.read"
      }
    },
    "/workspaces/{workspaceId}/upload": {
      "post": {
        "description": "仅接受有效密钥的 files.upload 权限与工作区授权；匿名或浏览器密码不授予 API 写入。与浏览器 allowUpload 独立。要求准确 Content-Length；空目录使用 directory=true 和零字节。代次、密钥或工作区撤销中止未发布内容。失败后重新传送完整文件。",
        "operationId": "uploadFile",
        "parameters": [
          {
            "in": "path",
            "name": "workspaceId",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "generation",
            "required": true,
            "schema": {
              "minimum": 1,
              "type": "integer",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "path",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "directory",
            "required": false,
            "schema": {
              "default": false,
              "type": "boolean",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "query",
            "name": "parent",
            "required": false,
            "schema": {
              "default": "",
              "description": "文档提供程序工作区的目标父目录 ID；空值为根目录。path 相对于此目录，不能传入 content URI。文件系统工作区只能省略或为空。",
              "maxLength": 4096,
              "type": "string",
              "x-legnasend-max-utf8-bytes": 4096
            }
          },
          {
            "in": "header",
            "name": "Content-Length",
            "required": true,
            "schema": {
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/octet-stream": {
              "schema": {
                "format": "binary",
                "type": "string"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UploadReceipt"
                }
              }
            },
            "description": "已创建并发布",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "路径或请求正文无效",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "密钥无效、过期或已撤销",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "缺少上传或工作区权限",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "工作区不可用",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "目标已存在或代次失效",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "411": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "需要准确的 Content-Length",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "415": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "需要 application/octet-stream",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "固定秒／分窗口或活动响应配额",
            "headers": {
              "Retry-After": {
                "schema": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "稳定错误码，不包含凭据或本机路径",
            "headers": {
              "X-LegnaSend-Remaining-Minute": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Remaining-Second": {
                "description": "4294967295 表示全局和调用方在此维度均不限额；否则返回最小剩余额度。",
                "schema": {
                  "maximum": 4294967295,
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "X-LegnaSend-Request-Id": {
                "schema": {
                  "format": "uuid",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "持有上传权限密钥，流式创建文件或空目录（不覆盖）",
        "x-legnasend-max-query-bytes": 8192,
        "x-legnasend-scope": "files.upload"
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "servers": [
    {
      "url": "/api/legnasend/v1/integration"
    }
  ],
  "x-legnasend-anonymous-policy": "关闭业务鉴权后，匿名授权只涵盖可见且未受密码保护的工作区；提供错误密钥不会降级成匿名。"
}