协议规则
传输方式：HTTPS
数据格式：JSON
签名算法：MD5 / KEY （二选一）
字符编码：UTF-8
请求网关：https://open-api.qqzwb.com
签名方式 & 请求参数
请求参数说明：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 应用ID | app_id | 是 | Int | 10001 | 应用管理 - 选择需使用的APPID |
| 签名类型 | sign_type | 是 | String | md5 | 签名类型，固定值: MD5 |
| 签名结果 | sign | 是 | String | 1f9e40c1a8713803a668e40f6c11c388 | MD5签名 |
KEY方式 & 请求参数
请求参数说明：?key=认证KEY&API接口请求参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 认证KEY | key | 是 | String | 7kK1jT4xqcphNy47NVkjNQVUy8gdyR7277yUNu5O | 平台中心 - 对接网关及参数 ，在使用之前主账户绑定Appid |
MD5签名算法
请对参数按照键名进行降序排序（a-z），Object对象,signature,key,sign,sign_type 和空值不进行签名！。
排序后请操作参数生成或拼接一个url请求字符串 例如 a=b&c=d&e=f (Url值不能携带参数！不要进行urlencode)
再将拼接好的请求字符串与平台生成的Key进行MD5加密得出sign签名参数 md5 ( a=b&c=d&e=f + KEY )
(注意：+ 为各语言的拼接符！不是字符！)，结果不分大小写。
Qzone说说
接口URL： /api/api_helper/get_ss_v2
请求方式：POST / GET
调用描述：获取QQ空间说说
请求参数列表：
| 字段名 | 变量名 | 必填 | 类型 | 默认值 |
|---|---|---|---|---|
| QQ号 | uin | 是 | string | |
| 页码 | page | 否 | string / int | 1 |
响应参数：data字段
| 字段名 | 变量名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 说说ID | tid | 是 | int | |
| 标题 | title | 是 | string | |
| 发布时间(时间戳格式) | time | 是 | string |
Qzone日志
接口URL： /api/api_helper/get_rz_log_v2
请求方式：POST / GET
调用描述：获取QQ空间发布的日志
请求参数列表：
| 字段名 | 变量名 | 必填 | 类型 | 默认值 |
|---|---|---|---|---|
| QQ号 | uin | 是 | string | |
| 页码 | page | 否 | string / int | 1 |
响应参数：data字段
| 字段名 | 变量名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 日志ID | tid | 是 | int | |
| 标题 | title | 是 | string | |
| 发布时间(时间戳格式) | time | 是 | string |
二维码解析
接口URL： /api/api_helper/parse_qr
请求方式：POST
调用描述：二维码解析，支持模糊类型二维码。可上传文件的后缀：jpeg, png, bmp, gif, svg, or webp。文件最大不能超于2.5MB
请求参数列表：
| 字段名 | 变量名 | 必填 | 类型 | 默认值 |
|---|---|---|---|---|
| 二维码图片 | file | 是 | FileObject |
响应参数：data字段
| 字段名 | 变量名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 解析结果 | data | 是 | string | 暂无 |
错误码列表
响应码非等于 0 均已视为失败，具体失败原因msg字段会提示。
| 响应码 | 错误信息 |
|---|---|
| 0 | 请求成功 |
| -102 | 请求失败 |
| -100 | 签名错误 |
| -103 | 请求已达到上限 |
| -200 | App应用不存在 |
| -204 | KEY不存在 |
| -205 | App应用异常 |
| -201 | 主账户信息丢失 |
| -202 | 主账户异常 |
| -106 | 参数效验失败 |
| -300 | Ip不在白名单中 |
| -303 | 点数不足或VIP可调用次数已上限 |
| -400 | 接口正在维护中 |
| -411 | 接口不存在 |
| -422 | 接口配置项错误 |
| -423 | 对接方式不被允许 |
| -425 | 接口层失效 |
| -424 | 接口上游未能作出正确响应 |
| -500 | 系统异常 |
SDK下载
SDK.zip
SDK版本：V1.1