Skip to content

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_idinteger是当前框架内的账号 QQ 号
protocol_idinteger是账号协议配置 ID;从 get_protocol_list 获取,必须显式传入,0 也是有效 ID
client_idinteger否第三方应用客户端 ID
response_typestring否应用授权响应类型
openapiinteger[]否申请的开放 API 权限列表
pfstring否平台标识
need_payinteger否支付授权选项
signstring否签名资料或授权签名
sdkvstring否SDK 版本
sdkpstring否SDK 平台
timeinteger否业务时间戳
pass_datastring否授权透传数据
app_unique_identifierstring否应用唯一标识
refererinteger否授权来源标识
vidinteger否授权业务标识
url_encoded_datastring否URL 编码的业务数据
auth_typeinteger否授权类型

返回值 ​

以下为成功响应的 data,错误通过 ok: false 与 error 返回。

字段类型说明
retinteger业务返回码
msgstring业务提示
access_tokenstring第三方应用访问令牌
expires_ininteger有效期秒数
openidstring第三方应用 OpenID
pay_tokenstring支付令牌
encrytokenstring上游加密令牌字段
pfstring平台标识
pfkeystring平台授权密钥
encrykeystring上游加密密钥字段
md5keystring上游 MD5 密钥字段
sendinstallinteger上游安装状态值
installwordingstring应用安装提示文字
pass_data_respobject[]授权返回透传数据
pass_data_resp[].keystring字段名
pass_data_resp[].valuestring字段值
sign_qqkeystringQQ 授权签名密钥
md5_qqkeystringQQ 授权 MD5 密钥字段
callback_urlstring授权回调 URL
universal_linkstring应用通用链接
pause_durationinteger上游暂停时间

萌卡 · 自托管 QQ 机器人框架