sdk_auth_api
使用当前账号请求第三方应用的 SDK 授权。
此接口在已认证的服务连接中调用,账号须属于当前框架且处于在线状态。self_id 与 protocol_id 共同选择账号。
适用协议
Android(手机 / 平板);不支持 Linux QQ。
调用方式
向已认证的 WebSocket 连接发送:
json
{
"type": "action",
"id": "example-1",
"action": "sdk_auth_api",
"params": {
"self_id": 123456789,
"protocol_id": 0
}
}响应通过相同 id 对应请求。连接、HTTP 调用与错误处理见通信协议。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id | integer | 是 | 当前框架内的账号 QQ 号 |
protocol_id | integer | 是 | 账号协议配置 ID;从 get_protocol_list 获取,必须显式传入,0 也是有效 ID |
client_id | integer | 否 | 第三方应用客户端 ID |
response_type | string | 否 | 应用授权响应类型 |
openapi | integer[] | 否 | 申请的开放 API 权限列表 |
pf | string | 否 | 平台标识 |
need_pay | integer | 否 | 支付授权选项 |
sign | string | 否 | 签名资料或授权签名 |
sdkv | string | 否 | SDK 版本 |
sdkp | string | 否 | SDK 平台 |
time | integer | 否 | 业务时间戳 |
pass_data | string | 否 | 授权透传数据 |
app_unique_identifier | string | 否 | 应用唯一标识 |
referer | integer | 否 | 授权来源标识 |
vid | integer | 否 | 授权业务标识 |
url_encoded_data | string | 否 | URL 编码的业务数据 |
auth_type | integer | 否 | 授权类型 |
返回值
以下为成功响应的 data,错误通过 ok: false 与 error 返回。
| 字段 | 类型 | 说明 |
|---|---|---|
ret | integer | 业务返回码 |
msg | string | 业务提示 |
access_token | string | 第三方应用访问令牌 |
expires_in | integer | 有效期秒数 |
openid | string | 第三方应用 OpenID |
pay_token | string | 支付令牌 |
encrytoken | string | 上游加密令牌字段 |
pf | string | 平台标识 |
pfkey | string | 平台授权密钥 |
encrykey | string | 上游加密密钥字段 |
md5key | string | 上游 MD5 密钥字段 |
sendinstall | integer | 上游安装状态值 |
installwording | string | 应用安装提示文字 |
pass_data_resp | object[] | 授权返回透传数据 |
pass_data_resp[].key | string | 字段名 |
pass_data_resp[].value | string | 字段值 |
sign_qqkey | string | QQ 授权签名密钥 |
md5_qqkey | string | QQ 授权 MD5 密钥字段 |
callback_url | string | 授权回调 URL |
universal_link | string | 应用通用链接 |
pause_duration | integer | 上游暂停时间 |
