获取可进行宠物 PK 的好友列表。
调用
const result = await api.get_pet_pk_friends(self_id, cursor)
参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
self_id |
number | 是 | - | 在线 Bot QQ 号 |
cursor |
string | 否 | '' |
上一页返回的 next_cursor |
返回值
{
friends: [
{
pet_id: 'pet-123',
pet_name: '小卡',
user_id: '123456789',
nickname: '昵称',
dominant_type: 1,
power: 10,
pet_status: 1,
pet_resolved: true,
},
],
next_cursor: 'NEXT_CURSOR',
has_more: false,
source: 'pet_pool',
}
source 为 pet_pool 时,列表来自宠物服务并已携带真实宠物资料。宠物服务未返回候选项时,框架会返回普通 QQ 好友基础列表,source 为 qq_friend_fallback、pet_resolved 为 false;后续调用 PK 接口时,框架会根据 user_id 自动查询真实宠物资料。