服务端

请求结构

发起 API 请求的 URL 由不同参数拼接而成，有固定的请求结构。本产品服务端 API 请求结构主要由三部分组成：

• URL：指向具体的业务请求，请参见各个 API 接口文档。

• Header：包括云信 AppKey、CheckSum 等在内的鉴权信息。

• Body：包括 API 对应的请求参数。若接口没有请求参数，则无需传递 Body。

每篇 API 文档均给出了请求示例供您参考，请在发起请求前自行编码。接口调用成功会显示返回参数，调用失败则显示相应报错，您可以根据错误码分析排查。

Header

Header 中包括用于鉴权的相关参数，如非必要，每个接口单独的接口文档中不再对这些参数进行说明，但每次请求均需要携带这些参数，才能正常发起请求。

公共请求参数

接口鉴权

接口通过请求头中的公共参数进行鉴权。

本文档中提供的所有接口均面向开发者服务器端调用，开发者应妥善保管用于计算 CheckSum 的 AppSecret，可在应用的服务器端存储和使用，但不应存储或传递到客户端，也不应在网页等前端代码中嵌入。

计算 CheckSum 的 JAVA 代码示例如下：

import java.security.MessageDigest;
public class CheckSumBuilder {
    public static String getCheckSum(String appSecret, String nonce, String curTime) {
        return encode("sha1", appSecret + nonce + curTime);
    }
    private static String encode(String algorithm, String value) {
        if (value == null) {
            return null;
        }
        try {
            MessageDigest messageDigest = MessageDigest.getInstance(algorithm);
            messageDigest.update(value.getBytes());
            return getFormattedText(messageDigest.digest());
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }
    private static String getFormattedText(byte[] bytes) {
        int len = bytes.length;
        StringBuilder buf = new StringBuilder(len * 2);
        for (int j = 0; j < len; j++) {
            buf.append(HEX_DIGITS[(bytes[j] >> 4) & 0x0f]);
            buf.append(HEX_DIGITS[bytes[j] & 0x0f]);
        }
        return buf.toString();
    }
    private static final char[] HEX_DIGITS = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f' };
}

Body

服务端 API 请求的 Content-Type 为 application/json。传入的 Body 必须为 JSON 格式。

服务地址

网易云信直播服务使用的域名访问地址为：vcloud.163.com。

通信协议

网易云信直播服务的所有接口均通过 HTTPS 进行通信，提供高安全性的通信通道。

请求方法

所有接口都只支持 POST 请求。

字符编码

所有接口均使用 UTF-8 编码。

返回结构

所有接口返回类型为 JSON。返回字段如下：