伯索开放平台
首页API文档SDK文档
伯索官网
首页API文档SDK文档
伯索官网
  1. 服务端接口与协议
  • SDK 接入总览
  • 实时课堂
    • Android 实时课堂接入
    • Harmony 实时课堂接入
    • iOS 实时课堂接入
    • Electron 实时课堂接入
    • Web 实时课堂监课接入
  • 极速课堂
    • Android 极速课堂接入
    • Harmony 极速课堂接入
    • iOS 极速课堂接入
    • Electron 极速课堂接入
  • 微课
    • Android 微课接入
    • Harmony 微课接入
    • iOS 微课接入
    • Electron 微课接入
  • 资料中心
    • Android 资料中心接入
    • Harmony 资料中心接入
    • iOS 资料中心接入
    • Electron 资料中心接入
    • Web 资料中心接入
  • 文件预解析
    • Android 文件预解析接入
    • Harmony 文件预解析
    • iOS 文件预解析接入
    • Electron 文件预解析接入
  • 历史课堂回放
    • Android 历史课堂回放
    • Harmony 历史课堂回放
    • iOS 历史课堂回放
    • Electron 历史课堂回放
    • 播放器
      • 播放器 SDK 概述
      • 播放器 SDK 快速开始
      • 播放器 SDK 初始化与配置
      • 播放器 SDK 历史课堂回放
      • 播放器 SDK 移动端 WebView 嵌入
      • 播放器 SDK API 参考
      • 播放器 SDK 事件
      • 播放器 SDK 错误码
      • 播放器 SDK 常见问题
  • 云学堂模块化SDK
    • 云学堂模块化 SDK 概述
    • 云学堂模块化 SDK · Android 接入
    • 云学堂模块化 SDK · iOS 接入
    • 云学堂模块化 SDK · Harmony 接入
    • 云学堂模块化 SDK · PC 接入
    • 伯索云学堂跳转接入
  • 接入基础(Electron & Web)
    • Web
      • Web 概述
      • Web 快速开始:URL 接入监课
      • Web 初始化与配置(监课)
      • Web API 参考(监课)
      • Web 事件与回调(监课)
      • Web 错误码(监课)
      • Web 常见问题(监课)
    • Electron
      • Electron 概述
      • Electron 快速开始
      • Electron 初始化与配置
      • Electron API 参考
      • Electron 事件与回调
      • Electron 错误码
      • Electron 常见问题
  • 服务端接口与协议
    • 服务端接口与协议阅读顺序
    • 签名与鉴权
    • 签名示例
    • query 参数
    • 资料中心与文件 URL
    • 文档预解析
    • 课堂进行中数据回调
    • 课堂结束数据回调
    • 历史课堂转视频与下载
  1. 服务端接口与协议

签名示例

本文给出一套可以核对的进房签名,以及 Go、Java、Node.js、PHP 的对照实现。计算规则以《签名与鉴权》为准。
下面的密钥和参数只用于对照结果,不能当作正式环境凭证。正式环境的签名必须在客户服务端完成,客户端不要保存 appKey。

1. 签名要点#

用参数原文做 HMAC-SHA1,输出大写十六进制。计算时去掉 signature,其余参数名按 UTF-8 字节序升序排列,拼接为 key=value&key=value。值不做 URL 编码。对象和数组按 Go encoding/json 序列化。
参数名都是 ASCII 时,UTF-8 字节序与字母表升序相同。

2. 进课堂参数#

示例:appKey= 202611131865
字段参与签名的值
appId1865
appTypeliveclassSDK
d_dimension1280x720
envdev
loginNamet1
mediaTypevideo
meetingId20261113
meetingTypepublic
openFileMode1
userName老师1
userTypespeaker
validBegin1794553258
validTime10800
vendorType2
videoStream2
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=2
预期签名:6705EA6C8CF205CAA23718EB25CE36422596CBEB

3. 如何核对#

运行时会先打印 sign content: 和上面的待签名内容,再打印签名结果。
语言入口成功时看到
Go调用 LiveclassSignExample()符合预期
Javajavac -encoding UTF-8 Sign.java && java SignSIG 6705EA6C8CF205CAA23718EB25CE36422596CBEB
Node.jsnode sign.jsSIG 6705EA6C8CF205CAA23718EB25CE36422596CBEB
PHPphp sign.phpSIG 6705EA6C8CF205CAA23718EB25CE36422596CBEB
Go 示例是 package util 中的函数,没有 main。把它拷到项目里后调用 LiveclassSignExample()。Java、Node.js、PHP 可以直接按上表运行。

4. 实现代码#

Go#

sign.go

Java#

Sign.java

Node.js#

sign.js

PHP#

sign.php
修改于 2026-11-17 07:47:57
上一页
签名与鉴权
下一页
query 参数
Built with