跳转到正文
凭据类

获取 pskey

get_pskey:获取在线账号在指定域名下的网页登录凭证。

const KeyResult *get_pskey(uint64_t self_id, const char *platform, const char *domain);
void free_key_result(const KeyResult *result);
  • 权限:get_pskey
  • 调用要求:需要账号在线,可能等待网络回应,请在工作线程中调用

参数

参数类型必填说明
self_iduint64_t是在线 Bot QQ 号
platformconst char *是所属平台 PLATFORM_*
domainconst char *是目标域名(如 "qun.qq.com"),必填非空,凭据不能跨域名混用

返回值 KeyResult

用完必须调用 free_key_result(result) 交还;客户端未提供接口时返回 NULL。

字段类型说明
codeint32_t0 表示成功;get_pskey 被服务器拒绝时原样保留服务端结果码,本地失败为 RESULT_LOCAL_ERROR(-1)
keyconst char *凭据内容(clientkey 为十六进制小写),非 NULL
expires_atuint64_t到期时间(Unix 秒),未知时为 0
errorconst char *失败原因,非 NULL,无内容时为 ""

凭据属于敏感数据,切勿写入日志,也不要假定已复制的旧值会自动更新。

本页目录