公共参数

  • 公共参数包括 公共请求参数、公共返回参数以及公共错误码部分。

公共参数需要需要每次请求都附带上

eg : 请请求的接口为 www.domain.com/api/v1/room/delete?room_id=lss_123456

那么实际请求的接口为 www.domain.com/api/v1/room/deleteroom_id=lss_123456&app_id=abcdef&signed_at=189302463&sign=ec1218becfhgc

公共请求参数

  • 是指每个接口都需要使用到的请求参数。
参数 类型 是否必选 含义
app_id string 应用ID,详情参考应用ID(app_id)是什么?
signed_at string 当前UTC时间戳,从1970年1月1日0点0分0秒开始到现在的秒数
sign string 签名结果串,关于签名的计算方法,请参见 签名机制

公共返回参数

  • 用户发送的每次接口调用请求,无论成功与否,系统都会返回一个code给用户。
  • 如无特殊说明,接口中的出参均为data中的数据
参数 类型 是否必选 含义
code int 返回结果的状态码 (200 成功)
msg string 当返回结果的状态码不为200时,包含的错误信息
data json 返回的结果集
  • JSON
{
    "code": 200,  // 返回结果状态码
    "msg": "",      // 错误信息
    "data": {       // 返回结果数据
        "room_id": "lss_69178ce4"
    }
}

公共错误码

参数 类型 含义
10001 int 应用ID不能为空
10002 int 鉴权时间不能为空
10003 int 鉴权签名不能为空
20001 int 应用查询为空
20003 int 开发者不存在
30004 int 接口鉴权失败
30003 int 当前开发者尚未通过认证