走访好友宠物

API 开源贡献者：星空花海

走访目标好友宠物，提交前查询可用规则，提交后回读规则。

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

请求参数

参数	类型	必填	说明
self_id	number	是	在线机器人 QQ 号
client_type	string	是	当前实现支持 android；须使用 Android 账号
pet_id	string	是	目标好友的宠物 ID，必须与 friend_uin 对应
friend_uin	string	是	好友 QQ 号的十进制字符串；协议需要时显式传入

调用示例

const result = await api.visit_friend_pet({
  "self_id": 123456,
  "client_type": "android",
  "pet_id": "Njc4OTAtcGV0",
  "friend_uin": "67890"
})

返回结果

submitted、effect_verified、pet_id、friend_uin、rules_before、rules_after、trace；回读失败时含 verification_error。规则读取不等同于已确认业务效果。

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