凭据类
获取 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_id | uint64_t | 是 | 在线 Bot QQ 号 |
platform | const char * | 是 | 所属平台 PLATFORM_* |
domain | const char * | 是 | 目标域名(如 "qun.qq.com"),必填非空,凭据不能跨域名混用 |
返回值 KeyResult
用完必须调用 free_key_result(result) 交还;客户端未提供接口时返回 NULL。
| 字段 | 类型 | 说明 |
|---|---|---|
code | int32_t | 0 表示成功;get_pskey 被服务器拒绝时原样保留服务端结果码,本地失败为 RESULT_LOCAL_ERROR(-1) |
key | const char * | 凭据内容(clientkey 为十六进制小写),非 NULL |
expires_at | uint64_t | 到期时间(Unix 秒),未知时为 0 |
error | const char * | 失败原因,非 NULL,无内容时为 "" |
凭据属于敏感数据,切勿写入日志,也不要假定已复制的旧值会自动更新。