API 请求签名
如需访问融云服务端 API（Server API），您需要对 API 请求签名，使融云端验证应用程序的身份。
基本流程
- App Server 必须在认证服务中事先配置 App Key 和 App Secret，以确保后续的 API 调用能够顺利进行
- 在调用 Server API 时，需遵循特定的 HTTP 标头要求。HTTP 标头中的数据签名
signature需要使用 App Secret、随机数、时间戳进行计算 - 融云服务端收到请求后，会使用对应的 App Secret 进行同样的计算，并要求结果完全一致
- 注意 App Secret 不可泄漏。确保在网络传输过程中不暴露该信息，并且不要在不受信任的环境中（如浏览器等）存放 App Secret，以防止潜在的安全风险
获取 App Key / App Secret
获取应用的 App Key / App Secret 是使用融云 Server API 的必要条件。您可以前往控制台 App Key 页面进行查询。
您需要记录应用的 App Key 和 App Secret，在本教程中使用。在请求融云服务端 API 接口时，每个 HTTP 请求中需要携带应用的 App Key 与数据签名。App Secret 用于计算数据签名，请注意不要泄露。
HTTP 标头
App Server 调用 API 接口时，每个 HTTP 请求中均需要携带以下的 HTTP 标头字段（HTTP Request Header），用于向融云服务端提供身份认证信息：
| 默认名称 | 带 RC-前缀 | 类型 | 说明 |
|---|---|---|---|
| App-Key | RC-App-Key | String | 您可以从 控制台 获取应用和环境（开发/生产）的 App Key |
| Nonce | RC-Nonce | String | 随机数，不超过 18 个字符 |
| Timestamp | RC-Timestamp | String | 时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数 |
| Signature | RC-Signature | String | 数据签名。您需要参考下文的签名计算方法 生成该字段的值 |
| Room-Id | 无 | String | 音视频或直播的房间 ID。房间 ID 可通过融云服务端回调房间状态同步的 roomId 获取。详见房间状态同步 |
| Session-Id | 无 | String | 会话 ID。会话 ID 可通过融云服务端回调房间状态同步的 sessionId 获取。详见房间状态同步 |
注意
- Room-Id 为音视频或直播的房间 ID。获取 Token 时无需传入。其他情况下除非具体业务接口明确说明无需传入，否则均需要携带
- 某些 PaaS 平台（如 SAE）可能会过滤特定的 HTTP Header。如果您使用这些平台时遇到问题，可以使用带
RC-前缀的 HTTP Request Header，一般情况下使用默认的 HTTP Header 即可
签名计算方法
API 请求中需携带该数据签名（Signature）字段，该字段值需要由应用服务端计算生成。步骤如下：
- 登录控制台，获取与应用 App Key 所对应的 App Secret
- 将以下三个字符串按顺序（App Secret + Nonce + Timestamp）拼接成一个字符串，进行 SHA1 哈希计算：
- App Secret：应用 App Key 所对应的 App Secret
- Nonce：随机数
- Timestamp：时间戳
融云服务端在验证数据签名真实性后，会执行请求的动作。如果调用的数据签名验证失败，接口调用会返回 HTTP 状态码 401。其他状态码请参见状态码表。
以下是计算数据签名的 PHP 代码示例：
PHP
// 重置随机数种子
srand((double)microtime()*1000000);
$appSecret = 'your-own-app-secret'; // 请替换为您从开发者平台获取的 App Secret
$nonce = rand(); // 获取随机数
$timestamp = time()*1000; // 获取时间戳（毫秒）
$signature = sha1($appSecret.$nonce.$timestamp);
HTTP 请求示例
以下 HTTP 请求示例展示了 API 请求中的 HTTP 标头字段：
HTTP
POST /user/getToken.json HTTP/1.1
Host: api.rong-api.com
App-Key: your-own-app-key
Nonce: 14314
Timestamp: 1408710653000
Signature: 30be0bbca9c9b2e27578701e9fda2358a814c88f
Content-Type: application/x-www-form-urlencoded
Content-Length: 78
userId=jlk456j5&name=Ironman&portraitUri=http%3A%2F%2Fabc.com%2Fmyportrait.jpg