文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>事件中心

自定义角色-回调接口

最近更新时间：2025-12-02 10:49:55

我的收藏

本页目录：

一、概述

事件中心的处理人选择组件，支持自定义角色体系，事件中心在触发相关逻辑后，会调用自定义角色体系中配置的审批/通知接口，告知用户当前需要给哪些自定义用户发送审批/通知消息。要使用该功能，用户需要自定义接口来实现审批或通知的逻辑，并将接口调用地址配置在自定义角色体系中。

二、接口配置信息

接口地址（URL）

事件中心请求该地址告知当前需要给哪些自定义用户发送审批/通知消息以及消息内容，需要支持 https，请求方式为 HTTP POST，如：
https://127.0.0/api/v1/notify

接口Token

事件中心通过“接口地址”请求用户的自定义接口时，会在请求头中带上用户配置的 Token 作为身份认证。

三、接口协议

业务接口需要支持如下协议：

请求头（Headers）

参数名
类型
必填
说明
Content-Type
string
是
固定为 application/json
Authorization
string
否
用户自定义token加上固定前缀 Bearer XXX

审批请求体（Body）

参数名
类型
说明
示例值
OwnerUin
int
单据所属主账号 Uin
70001262112
Uin
int
单据发起人子账号 Uin
7000126388
TicketId
string
事件单据 ID
T2025080117540023702
Title
string
事件单标题
创建服务器
ApprovalId
string
审批单ID
A20250801812
ApprovalNodeId
string
审批节点ID
AN20250801812129
Content
string
内容
创建服务器审批
Member
[]string
审批人 ID 数组
["user1","user2"]
Tokens
[]string
审批人对应的Token，用于审批单据时的身份认证
["46b49b04e99ab34811f679e00c0","835459677b3c70745dc962144c8"]
SystemName
string
单据名称
创建服务器拦截
SystemTriggerTime
string
单据生成时间
2025-12-11 22:05:05
SystemUserName
string
单据创建人名称
user1

通知请求体（Body）

参数名
类型
说明
示例值
OwnerUin
int
单据所属主账号 Uin
70001268112
Uin
int
单据发起人子账号 Uin
7000126888
TicketId
string
事件单据 ID
T2025080117540113702
Title
string
事件单标题
创建服务器
Content
string
内容
创建服务器通知
Member
[]string
通知人 ID 数组
["user1","user2"]
SystemName
string
单据名称
创建服务器触发
SystemUserName
string
单据创建人名称
user1

四、调用示例

审批请求示例（cURL）

curl  -X POST -H "Content-Type: application/json"  http://127.0.0.1/api/v1/approval -d '{
    "OwnerUin": 10000000001,
    "Uin": 10000000001,
    "TicketId": "T20251212126370468",
    "ApprovalId": "A2025121117461963139",
    "ApprovalNodeId": "AN2025121165461963141",
    "Title": "操作通知",
    "Content": "删除用户组审批",
    "Member": [
        "user2",
        "user1"
    ],
    "Tokens": [
        "46b49b04e998cab34811f679e00c0",
        "83545967a8c48c70745dc962144c8"
    ],
    "SystemName": "删除用户组审批",
    "SystemTriggerTime": "2025-12-11 22:05:05",
    "SystemUserName": "user1"
}'


通知请求示例（cURL）

curl  -X POST -H "Content-Type: application/json"  http://127.0.0.1/api/v1/notify -d '{
    "OwnerUin": 10000000001,
    "Uin": 10000000001,
    "TicketId": "T20251211721370468",
    "Title": "操作通知",
    "Content": "删除用户组审批",
    "Member": [
        "user2",
        "user1"
    ],
    "SystemName": "删除用户组审批",
    "SystemUserName": "user1"
}'




中国站
目录