公共约定 - 蜻蜓FM API

若无特殊说明，蜻蜓FM服务端接口使用如下公共约定。

api访问只支持https协议。测试接入域名为 open.staging.qingting.fm，正式域名上线前再分配。

若对信息安全有较高要求，可以在https通信基础上增加接入方客户端对蜻蜓的证书锁定（附蜻蜓FM开放平台根证书地址https://dl.cacerts.digicert.com/DigiCertGlobalRootCA.crt）

请求和响应的body都使用json，编码方式为utf-8。

以下字段为所有API的公共参数，若无特殊说明所有请求都带有下列参数，通过header或query传入，如果同时提供query会覆盖header对应值。

header字段	query字段	值及说明
QT-Device-Id	device_id	当前接入方设备的设备号，务必保证设备号和设备一一对应，安卓设备建议填imei或md5(imei)；若在接入方服务端调用需透传接入方客户端的设备号
QT-Access-Token	access_token	当前用户（匿名或具名）的授权凭据，授权之前请使用空字符串
QT-User-Id	user_id	用户在蜻蜓侧的ID，由授权登录或静默登录获取。匿名用户请使用空字符串
QT-Coop-Open-Id	coop_open_id	合作方用户ID，用来反查蜻蜓id（仅当使用client_credentials模式得到的token时生效）。如无需求，可以不用传
QT-Device-OS	device_os	设备操作系统(Android or ios)
QT-Device-OS-Version	device_os_version	设备操作系统版本
QT-App-Version	app_version	设备应用版本
QT-Device-Model	device_model	机型

响应都使用如下格式

{
    "data": {},
    "errcode": 123,
    "errmsg": "..."
}

分页读取列表的接口都有page和pagesize参数。page表示第几页，不填默认为1；pagesize表示每页大小。pagesize只能选择30或500，默认30。

分页读取列表的接口都会返回page，pagesize，total字段。

时间戳，超时时长，节目时长等时间单位都是秒。

部分api和所有的对外通知都要求对请求签名，以"QT-Sign"为键放入请求header中。生成签名的规则：sign_content(需要签名的内容，每个api可能不一样) 和 sign_key(默认client_secret) utf-8编码后拼在一起后，计算16进制md5摘要并大写。例如sign_key=123，sign_content为{"data":{"id":242222},"type":"channel_offline"}，则签名为 md5hex('{"data":{"id":242222},"type":"channel_offline"}123').toUpperCase() = 391BD167845018EC270F7FDF29CAD218