获取 SDK Token

1 描述

获取 sdk_token，用于客户端登录鉴权。

2 接口原型

• 请求方法：POST

• 请求地址：

  服务环境	调用频率限制	请求地址
  正式环境	10 次/秒	https://roomkit-api.zego.im/auth/get_sdk_token

• 传输协议：HTTPS

3 请求参数

sign 中各字段说明如下：

4 请求示例

以下是 sdk_token 接口的请求示例。

{
    "common_data": {
        "platform": 8
    },
    "sign": "CIE7hNPK6Y55DeUJBQWERTY",
    "secret_id": 12580,
    "device_id": "38-F9-D3-87-C8-15",
    "timestamp": 1615541262
}

5 响应参数

6 响应示例

以下是 sdk_token 接口的响应示例。

{
    "ret": {
        "code": 0,
        "message": "succeed",
        "version": "1.0.0"
    },
    "data": {
        "sdk_token": "sdk_token",
        "expires_in": 86400
    }
}

7 示例代码

7.1 Python 示例代码

import time
import hashlib
import json
import requests

def get_SDK_token(secret_id, secret_sign, deviceid, platform):
    timestamp = int(time.mktime(time.localtime(time.time()))) + 3600
    signSrc = ("%s%s%d%d%d" % (secret_sign[:32], deviceid, 3, 1, timestamp))
    sign = hashlib.md5(signSrc.encode()).hexdigest()
    url = 'https://roomkit-api.zego.im/auth/get_sdk_token'
    data = {
        "common_data": {
            "platform": platform,
        },
        "sign": sign,
        "secret_id": secret_id,
        "device_id": deviceid,
        "timestamp": timestamp
    }
    r = requests.post(url=url, json=data)
    respondStr = r.text.encode('utf-8').decode('utf-8')
    sdk_token = json.loads(respondStr)["data"]["sdk_token"]
    return sdk_token

7.2 Golang 示例代码

import (
    "bytes"
    "crypto/md5"
    "encoding/json"
    "errors"
    "fmt"
    "io/ioutil"
    "net/http"
    "testing"
    "time"
)

func GetSDKToken(secretId int, secretSign, deviceId string, platform int) (sdkToken string, err error) {
    // 过期时间
    expired := time.Now().Unix() + 3600

    // 计算hash
    m := md5.New()
    m.Write([]byte(fmt.Sprintf("%s%s%d%d%d", secretSign[:32], deviceId, 3, 1, expired)))
    hash := fmt.Sprintf("%x", m.Sum(nil))

    var reqStruct struct{
        CommonData  struct{
            Platform int     `json:"platform"`
        }
        SecretId     int     `json:"secret_id"`
        Sign         string    `json:"sign"`
        DeviceId     string    `json:"device_id"`
        Timestamp    int64   `json:"timestamp"`
    }
    reqStruct.CommonData.Platform = platform
    reqStruct.SecretId = secretId
    reqStruct.Sign = hash
    reqStruct.DeviceId = deviceId
    reqStruct.Timestamp = expired
    reqBody, _ := json.Marshal(reqStruct)

    // 发送post请求
    req, err := http.NewRequest(http.MethodPost, "https://roomkit-api.zego.im/auth/get_sdk_token", bytes.NewBuffer(reqBody))
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    var resp *http.Response
    resp, err = client.Do(req)
    if err != nil {
        return
    }
    defer resp.Body.Close()

    var respBody []byte
    respBody, err = ioutil.ReadAll(resp.Body)
    if err != nil {
        return
    }

    var ret struct{
        Ret struct{
            Code     int     `json:"code"`
            Msg     string    `json:"msg"`
            Version string    `json:"version"`
        }                    `json:"ret"`
        Data struct{
            SDKToken     string    `json:"sdk_token"`
        }
    }

    err = json.Unmarshal(respBody, &ret)
    if err != nil {
        return
    }
    if ret.Ret.Code != 0 {
        return "", errors.New(ret.Ret.Msg)
    }

    return ret.Data.SDKToken, nil
}