get_pet_pk_friends

获取可进行宠物 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 自动查询真实宠物资料。