# 订阅工作流

订阅后将会收到对应工作流的变更通知

  • 任务被创建
  • 任务状态变化
  • 任务字段变更
  • 新增评论

注意事项:

  • 出于安全角度考虑，当您发起订阅接口调用后，系统会为您创建对应的审批流程，审批通过后变更推送机制才会正式生效，审批流程开放平台管理人员-工作流管理人员

# 请求

基本
HTTP URL https://hi-qa.weizhipin.com/open-apis/workflow/v1/subscribe/:workflow_id
HTTP Method POST
支持的应用类型 自建应用
权限要求开启任一权限即可 [工作流]-[获取工作流变更事件]

# 请求头

名称 类型 必填 描述
Authorization string 是 tenant_access_token
值格式："Bearer access_token"
示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560"
Content-Type string 是 固定值："application/json; charset=utf-8"

# 路径参数（url中冒号标识的参数,如":xxxx"请连同:整体替换成对应值）

名称 类型 描述
workflow_id string 工作流id

# 查询参数（url后?&拼接的参数）

名称 类型 描述
uuid string 由开发者生成的唯一字符串序列，用于发送消息请求去重；持有相同uuid的请求1小时内至多成功执行一次，示例值："a0d69e201dd1-458b-k525-dfeca4015204" 数据校验规则： 最大长度：50 字符
user_id string 工作流订阅审批发起人user_id值
user_id_type string 代表工作流订阅审批发起人用户 ID 类型示例值："open_id"
可选值有：
open_id：用户的 open id
union_id：用户的 union id
user_id：用户的 user id
默认值：open_id
当值为 user_id时，存在字段权限要求，未开通则会调用失败：
请参见[应用权限管理]-[通讯录]- [获取用户ID]

# 响应

# 响应体

{
  "code": "0",
  "traceId": "",
  "data": true,
  "msg": "已为您自动发起审批，请进入Boss Hi工作台-审批-我的审批查看进度"
}
1
2
3
4
5
6

如果响应非成功状态，请对照 错误码文档

最后更新于 : 3/4/2024, 3:29:16 PM

← 取消工作流订阅 →