飞书项目帮助中心Appearance
状态流转
请求体说明
| 类别 | 值 |
|---|---|
| 请求地址 | {base_url}/open_api/:project_key/workflow/:work_item_type_key/:work_item_id/node/:node_id/operate |
| 请求方式 | POST |
请求 Header
| 字段 | 值 | 必须填写 |
|---|---|---|
| Content-Type | application/json | 必须 |
| X-PLUGIN-TOKEN | 用户在开放平台中获取的 Token，参考插件身份凭证章节。 | 必须 |
| X-USER-KEY | 当选择使用插件身份凭证的时候，需要额外必选指定接口调用的用户user_key，user_key可双击用户头像获取 | 可选 |
| X-IDEM-UUID | 写类型接口的幂等串，可以不设置，设置后会进行同一个X-PLUGIN-TOKEN下同一接口的幂等判断 | 可选 |
参考请求格式如下：
curl --location -g --request GET '/open_api/:project_key/workflow/:work_item_type_key/:work_item_id/node/:node_id/operate' \
--header 'X-PLUGIN-TOKEN: {{token}}' \
--header 'X-USER-KEY: {{user_key}}' \
--data-raw ''
路径参数
| 参数名 | 是否必填 | 值类型 | 说明 |
|---|---|---|---|
| project_key | 是 | string | 空间id [project_key]，或者空间域名 [simple_name] |
| work_item_type_key | 是 | string | 工作项类型，可以从获取工作项类型接口获取。 |
| work_item_id | 是 | int64 | 工作项 ID |
请求参数
| 参数名 | 是否必填 | 值类型 | 说明 |
|---|---|---|---|
| transition_id | 是 | int64 | 流转到下一状态的id，从获取工作流详情接口查询状态流获取。 |
| role_owners | 否 | list[RoleOwner] | 角色及负责人 |
| fields | 否 | list[FieldValuePair] | 要更新的字段数组，只能更新状态表单。 |
请求体格式
{
"transition_id":12345
}
返回格式
{
"data":{},
"err": {},
"err_msg": "",
"err_code": 0
}