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。规则读取不等同于已确认业务效果。
参数或业务错误会使调用失败。写入请求结果未知时，请先读取当前状态确认，勿直接重复提交。