测试回调接口

POST

/v1/webhook/test

回调接口说明

调用该接口会向回调配置中添加的 callback_url 发送一个请求
1.1 Header 包含一个 X-Signature 校验头， X-Timestamp 时间戳
1.2 Body格式： {"message_id":"msg_xxx","data":"加密内容"}
1.3 用户可根据自身需要对消息内容进行校验，加密方式：HMAC-SHA256 通过Header中X-Timestamp的内容+Body中的data数据，以及创建回调配置时返回的加密串 security_config 进行解密校验

该接口需要一个正确的响应
2.1 响应内容需要包含 message_id 这个与后续消息推送的响应一致
2.2 测试接口需要额外返回biz_data 进行校验
2.2.1 解密逻辑通过 AES-256-GCM 方式进行解密，最终得到 {"biz":[{"biz_type":"xiaoman.open.callback.test","biz_data":"xxx"}]} 的数据结构
2.3 响应体结构： {"code":200,"data":{"message_id":"msg_xxx","data":"xxx"}}

JS 签名校验示例

JS 解密示例

请求参数

无

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 200,
    "message": "success",
    "now": "2025-09-25 12:36:59"
}

修改于 2025-10-24 04:45:15

删除回调配置

重新生成加密密钥

测试回调接口

回调接口说明#

请求参数

请求示例代码

返回响应

回调接口说明