1. 首页
  2. API 文档
  3. QQ 宠物
  4. get_pet_pk_friends

get_pet_pk_friends

  • 发布于 2026-08-16
  • 16 次阅读

获取可进行宠物 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',
}

sourcepet_pool 时,列表来自宠物服务并已携带真实宠物资料。宠物服务未返回候选项时,框架会返回普通 QQ 好友基础列表,sourceqq_friend_fallbackpet_resolvedfalse;后续调用 PK 接口时,框架会根据 user_id 自动查询真实宠物资料。