设置回调地址

接口说明

该接口用于设置企业数据回调地址（Callback URL），并在保存前对回调地址进行有效性校验。只有通过校验的回调地址才会被成功保存，用于后续数据推送。

1. 校验机制说明（非常重要 ⚠️）

在设置回调地址时，我们会向你提供的 url 发起一次 GET 请求进行校验。

1.1 请求方式

GET {callbackUrl}?nonce=xxx&timestamp=xxx&signature=xxx&echoStr=xxx

1.2 请求参数说明

参数名	说明
nonce	随机字符串
timestamp	当前时间戳（秒）
signature	签名（见下方算法）
echoStr	随机字符串，用于校验

2. 签名算法

签名生成规则如下：

将以下参数放入 Map：

nonce
timestamp
signSecret

按参数名排序（字典序）

拼接成 URL 参数形式（去掉&和=）：

noncexxxsignSecretxxxtimestampxxx

使用 MD5 加密，生成 signature

3. 你需要实现的逻辑

✅3.1 校验签名（建议做）

按相同规则生成 signature，并对比请求中的 signature

✅3.2 原样返回 echoStr（必须）

4. 校验成功标准

我们认为回调地址有效的条件：
✅ 返回内容完全等于 echoStr
否则：
❌ 校验失败，接口返回错误

5. 失败情况说明

以下情况会导致设置失败：

回调地址不可访问

请求超时（5秒）

返回值不等于 echoStr

接口异常 / 抛错

签名错误（如果你做了校验）

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Bodyapplication/json

示例

按照接口说明设置回调地址，保证get校验接口能公网访问

{
    "timestamp": 1774255546,
    "code": 4001,
    "message": "回调地址校验失败",
    "data": null,
    "errorData": null
}

1. 校验机制说明（非常重要 ⚠️）#

1.1 请求方式#

1.2 请求参数说明#

2. 签名算法#

3. 你需要实现的逻辑#

✅3.1 校验签名（建议做）#

✅3.2 原样返回 echoStr（必须）#

4. 校验成功标准#

5. 失败情况说明#

请求参数