流程
当消息卡片中的交互控件被触发时,若卡片需要回调则开放平台会向你配置的消息卡片请求网址发起POST请求回调。
第一步 配置卡片请求地址URL
- 登录管理平台,进入应用管理,编辑对应应用,选择机器人菜单
- 打开机器人,然后在消息卡片POST请求地址中输入你的卡片回调地址
- 点击 验证 或 保存 时,开放平台会向你配置的请求地址发送一个
application/json
格式的POST请求,用于验证你所配置地址的合法性
请求示例如下:
{
"challenge": "2fcd3339d69f4522b43f6ea377f70a63",
"type": "url_verification",
}
参数说明:
字段名称 | 字段类型 | 说明 |
---|---|---|
challenge | string | 需要在响应中原样返回的值 |
type | string | 表示当前请求为验证URL合法性 |
需要在3秒内将challenge值(JSON格式)原样返回给开放平台,否则请求地址验证失败。返回示例如下:
{
"challenge": "2fcd3339d69f4522b43f6ea377f70a63",
}
- 验证通过后,单击保存完成配置
第二步 接收并响应回调请求
-
当回调请求发生时,开放平台会将回调数据发送到你预先配置的请求地址
-
回调报文以
HTTPS
或HTTP
的方式进行传输,使用POST
方法,报文格式限定为 JSON 格式 -
应用服务器需按规定的格式响应回开放平台,具体响应格式查看 数据内容
签名校验
UC回调请求会在请求头authorization中带上事件订阅菜单下的Token,应用可以通过校验该Token判断是否来自开放平台。