创建可信设备策略接口

新增可信设备策略，为所选人员设置设备可信校验和首台设备自动信任规则。通过 priority 指定匹配顺序，通过 scope_type 和 subjects 指定人员范围。

所需权限

POST /api/openapi/v1/trusted-device-policies

认证与请求头

使用应用 API Key 调用。当前接口校验上方独立 Scope；读取、管理与执行权限互不包含。

请求参数

请求示例

将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址，并填写实际参数。示例中的占位值不能直接用于请求。

curl --request POST --url '<BASE_URL>/api/openapi/v1/trusted-device-policies' --header 'Authorization: Bearer <API_KEY>' --header 'Idempotency-Key: <UNIQUE_REQUEST_ID>' --header 'Content-Type: application/json' --data '{  "description": "<string>",  "first_device_auto_trust": false,  "name": "<string>",  "priority": 1,  "scope_type": "all",  "subjects": [{"id": "<uuid>","name": "<string>","type": "department"}  ],  "validation_enabled": false}'

响应

201 创建成功，返回新建的记录。

{
  "created_at": "2026-08-27T10:00:00Z",
  "created_by": "<uuid>",
  "created_by_email": "<string>",
  "created_by_name": "<string>",
  "description": "<string>",
  "first_device_auto_trust": false,
  "id": "<uuid>",
  "is_default": false,
  "name": "<string>",
  "priority": 0,
  "scope_type": "all",
  "subjects": [
    {
      "id": "<uuid>",
      "name": "<string>",
      "type": "department"
    }
  ],
  "updated_at": "2026-08-27T10:00:00Z",
  "updated_by": "<uuid>",
  "updated_by_email": "<string>",
  "updated_by_name": "<string>",
  "validation_enabled": false,
  "version": 0
}

default 请求失败，返回错误码和错误详情。

{
  "code": "<string>",
  "detail": "<string>",
  "details": {
    "field": "<string>",
    "reason": "<string>",
    "suggestion": "<string>"
  },
  "error": "<string>"
}