所有接口请求均需要生成 sig 签名，用于验证请求是否合法。

签名算法

sig = MD5(
    排序后的参数字符串 + app_secret
)

说明
sig 参数本身不参与签名
MD5 输出大小写均可（服务端不区分大小写）
参数值必须与实际请求保持一致

签名示例

假设请求参数如下：

参数	值
app_id	`qnFDyq7dGYduSGuQFH7lwu2AawyuV3OL`
app_secret	`PpNS8GsTOpo8tTXpDIqR0rU4Lmil3psP`
begin	`1605456000`
end	`1605542400`
data_type	`report`
limit	`20`
source_type	`eve`
sig_time	`1605579971`

对应请求：

查询 2020-11-16 00:00:00 ~ 2020-11-17 00:00:00
大型测肤仪(report)第一页
每页20条数据

第一步：确定参与签名的参数

除 sig 外，其余所有请求参数均参与签名。

本例参与签名的参数为：

app_id
begin
data_type
end
limit
sig_time
source_type

第二步：按照参数名排序

按照参数名称 ASCII 字典序升序排列。

排序结果：

app_id
begin
data_type
end
limit
sig_time
source_type

第三步：拼接参数字符串

按照下面格式拼接：

key1=value1&key2=value2&key3=value3...

得到：

app_id=qnFDyq7dGYduSGuQFH7lwu2AawyuV3OL&
begin=1605456000&
data_type=report&
end=1605542400&
limit=20&
sig_time=1605579971&
source_type=eve

去掉换行后：

app_id=qnFDyq7dGYduSGuQFH7lwu2AawyuV3OL&begin=1605456000&data_type=report&end=1605542400&limit=20&sig_time=1605579971&source_type=eve

第四步：拼接 app_secret

直接在字符串末尾追加 app_secret，不要增加任何连接符。

最终待签名字符串：

app_id=qnFDyq7dGYduSGuQFH7lwu2AawyuV3OL&begin=1605456000&data_type=report&end=1605542400&limit=20&sig_time=1605579971&source_type=evePpNS8GsTOpo8tTXpDIqR0rU4Lmil3psP

第五步：计算 MD5

对最终字符串进行 MD5 运算。

得到：

dbb6ad9955f84cdf6621c96cb22ca781

该值即为请求中的 sig 参数。

最终请求参数

app_id=qnFDyq7dGYduSGuQFH7lwu2AawyuV3OL
begin=1605456000
end=1605542400
data_type=report
limit=20
source_type=eve
sig_time=1605579971
sig=dbb6ad9955f84cdf6621c96cb22ca781

Java Demo

PHP Demo

Python Demo

JavaScript (Node.js) Demo

Go Demo

注意事项

sig 参数不参与签名。

所有参数均按照参数名 ASCII 字典序排序。

参数之间使用 & 连接。

app_secret 直接追加到字符串末尾，不添加 & 或其他分隔符。

使用 UTF-8 编码进行 MD5 计算。

MD5 输出大小写均可，推荐统一使用小写。

参数值必须与实际请求一致，否则签名校验将失败。

Sig 签名生成规则

签名算法#

签名示例#

第一步：确定参与签名的参数#

第二步：按照参数名排序#

第三步：拼接参数字符串#

第四步：拼接 app_secret#

第五步：计算 MD5#

最终请求参数#

Java Demo#

PHP Demo#

Python Demo#

JavaScript (Node.js) Demo#

Go Demo#

注意事项#