Skip to content

get_pet_pk_strangers ​

API 开源贡献者:星空花海

可选 mode,默认 4;模式 4 过滤无效条目,单页最多 100 条。

  • action:get_pet_pk_strangers
  • 支持协议:Android。
  • 调用方式:普通插件 API;仅接受对象参数。

调用方式 ​

js
const result = await api.get_pet_pk_strangers({
  "self_id": 123456,
  "client_type": "android",
  "mode": 4
})

mode 写入 pkFriendList 请求的 field 2;其他模式的业务含义与结果由上游决定。get_pet_pk_friends 仍固定使用模式 6。

参数 ​

参数类型必填说明
self_idnumber是在线机器人 QQ 号
client_typestring是当前实现支持 android;须使用 Android 账号
cursorstring否服务端返回的下一页游标
modenumber否非负安全整数;省略默认 4,显式传入 0 或其他值原样发送

返回值 ​

friends[]、next_cursor、has_more。条目包含 pet_id、pet_name、user_id、nickname、pet_status、dominant_type、displayed_pk_power。

参数或业务错误会使调用失败。写入请求结果未知时,请先读取当前状态确认,勿直接重复提交。

版本限制 ​

服务返回 1000120 时,本次目录查询失败,不会用普通 QQ 好友或空列表冒充宠物目录。已有真实 pet_id 时,可直接调用 get_pet_vitals、get_pet_pk_power 或传入 pet_id 调用 get_friend_pet_profile,无需先查目录。

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