跳转到主要内容
POST
curl
创建一个蓝图。content_config 会经过严格校验:只接受六个已知章节及其文档中列出的键,因此拼写错误会返回 400,而不是被静默忽略。

相关内容

授权

x-api-key
string
header
必填

您的应用 API 密钥,可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域:针对每个资源设为无权限、只读或读写,限定于特定工作流或已通过的会话、限定于 IP 地址列表,以及设置到期日期。401 表示密钥错误、已撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或操作,或请求来自其 IP 列表之外的地址;在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null;没有会话写入权限的密钥获取到的会话链接和 token 将为 null。请参阅 https://docs.didit.me/console/api-keys。

路径参数

organization_id
string<uuid>
必填

组织 UUID。

application_id
string<uuid>
必填

应用 UUID。

请求体

application/json
name
string
必填

最多 24 个字符,例如“AML 调查”。

Maximum string length: 24
assignee_pool
string<uuid>[]
必填

用户 UUID 列表。空数组将被拒绝并提示 "Pick at least one assignee"。

Minimum array length: 1
description
string | null
assignment_method
enum<string>
默认值:MANUAL
可用选项:
MANUAL,
AUTOMATIC
max_active_cases
integer | null

自动模式阈值:“分配此蓝图的案件少于 N 个”。

必填范围: x >= 1
escalation_enabled
boolean
默认值:false
escalation_blueprint
string<uuid> | null

目标蓝图 UUID。在保存时不进行强制校验,但在 escalation_enabled 和 escalation_blueprint 均设置之前,上报操作将失败并返回 400。

transfer_enabled
boolean
默认值:false
four_eyes_checker_blueprint
string<uuid> | null

设置此项可启用双人复核:此蓝图上的决策结果将暂存到审核蓝图的队列中。

require_resolution_note
boolean
默认值:false
content_config
object

控制案件页面上显示哪些标签页和字段的六个可切换板块。未知的板块或键将被拒绝。

is_active
boolean
默认值:true
default_deadline_hours
integer | null

新开启案件的默认截止时间。现有案件的截止时间保持不变。

必填范围: 1 <= x <= 8760
publish
boolean
默认值:true
write-only

设置为 false 可保存未发布的草稿。在草稿显式发布之前,记录将保持非活动状态且版本为 0。省略此字段可保持现有集成的立即创建行为。

响应

Blueprint 已创建。

uuid
string<uuid>
name
string
Maximum string length: 24
description
string | null
assignment_method
enum<string>
可用选项:
MANUAL,
AUTOMATIC
assignee_pool
string<uuid>[]
max_active_cases
integer | null
escalation_enabled
boolean
transfer_enabled
boolean
require_resolution_note
boolean
is_active
boolean
preset_key
string | null
created_at
string<date-time>
escalation_blueprint
string<uuid> | null
escalation_blueprint_name
string | null
four_eyes_checker_blueprint
string<uuid> | null
four_eyes_checker_blueprint_name
string | null
content_config
object

控制案件页面上显示哪些标签页和字段的六个可切换板块。未知的板块或键将被拒绝。

creation_sources
object[]

当前将新案件路由到此蓝图的连接器。

receives_escalation_from
object[]

升级目标指向此蓝图的其他蓝图。

updated_at
string<date-time>
version
integer
read-only
default_deadline_hours
integer | null
必填范围: 1 <= x <= 8760
最后修改于 2026年11月7日