get_pet_pk_friends

API 开源贡献者：星空花海

模式 6；只返回服务端好友条目，不使用普通 QQ 好友兜底。

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

调用方式

const result = await api.get_pet_pk_friends({
  "self_id": 123456,
  "client_type": "android"
})

参数

参数	类型	必填	说明
self_id	number	是	在线机器人 QQ 号
client_type	string	是	当前实现支持 android；须使用 Android 账号
cursor	string	否	服务端返回的下一页游标

返回值

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，无需先查目录。