appId + appKey + HMAC-SHA1 签名校验请求来源和参数完整性。appKey 与 Open API / 部分文档 中的 signKey 是同一把密钥(移动端 Demo 习惯与 appId 成对写作 appKey)。详见《关键概念》。| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
appId | string | 是 | 伯索分配的应用标识 |
validBegin | number | 是 | 签名生效时间,Unix 秒级时间戳,必须为整数 |
validTime | number | 是 | 有效时长,单位秒 |
signature | string | 是 | HMAC-SHA1 计算结果,Hex 大写 |
signature 本身。appId、validBegin、validTime 和业务参数。signature。该字段不参与计算。true 或 false;空值写成空字符串。对象和数组按 Go encoding/json 序列化。不要先做 URL 编码。key=value 拼接,参数之间用 & 连接。appKey 对这条原文做 HMAC-SHA1。signature。signature 加回参数。组成 query 或 URL 时,再对传输中的参数值做 URL 编码。202611131865 对应的签名是 6705EA6C8CF205CAA23718EB25CE36422596CBEB。query 里的 userName=%E8%80%81%E5%B8%881 只是传输编码,签名使用解码后的 老师1。appId=1865&appType=liveclassSDK&d_dimension=1280x720&env=dev&loginName=t1&mediaType=video&meetingId=20261113&meetingType=public&openFileMode=1&userName=老师1&userType=speaker&validBegin=1794553258&validTime=10800&vendorType=2&videoStream=2appIdvalidBeginvalidTime{
"query": "appId=plaso&appType=liveclassSDK&...&signature=XXXX",
"expireAt": 1703123756
}appId、validBegin、validTime 或 signature。validBegin、validTime 不是整数秒。validBegin + validTime 有效窗口内。appId 找不到对应密钥。| 错误 | 影响 | 建议 |
|---|---|---|
使用 appid | 与规范字段不一致,验签失败 | 统一使用 appId |
把 appKey 与 signKey 当成两把密钥 | 对接时反复确认「到底用哪把」 | 二者同一把;按文档字段名选用即可 |
Date.now()/1000 未取整 | 出现浮点秒,签名不稳定 | 使用整数秒 |
Android BigInteger(...).toString(16) | 可能丢失前导零 | Hex 输出必须补齐 40 位 |
客户端保存 appKey / signKey | 密钥泄露风险 | 正式环境只允许服务端签名 |
| 签名前 URL encode | 与服务端签名原文不一致 | 签名使用原文,组 query 时再编码 |
| 参数名未按 UTF-8 字节序排序 | 参数名含非 ASCII 字符时验签失败 | 按 UTF-8 字节升序排序 |
| 对象或数组使用语言默认字符串 | 与 encoding/json 结果不一致 | 对象和数组按 Go encoding/json 序列化 |
