跳转到正文
凭据类

获取 clientkey

get_client_key:获取在线账号当前提供的 clientkey(十六进制小写)。

const KeyResult *get_client_key(uint64_t self_id, const char *platform);
void free_key_result(const KeyResult *result);
  • 权限:get_client_key
  • 调用要求:需要账号在线

参数

参数类型必填说明
self_iduint64_t是在线 Bot QQ 号
platformconst char *是所属平台 PLATFORM_*

返回值 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,无内容时为 ""

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

本页目录