buy_pet_bath_item

API 开源贡献者：星空花海

购买数量 count 大于 0 即提交商城订单，不预查目录或校验目录数量上下限、步进。业务 result 和 order_id 按响应返回，由调用方判断购买结果。

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

请求参数

参数	类型	必填	说明
`self_id`	number	是	在线机器人 QQ 号
`client_type`	string	是	当前实现支持 android；须使用 Android 账号
`pet_id`	string	是	宠物 ID，须按接口说明区分本人或目标；不能用 QQ 号代替
`item_id`	string	是	洗护目录返回的用品 ID，使用数字字符串，例如 "1"；框架按商城整数类型编码
`count`	number	是	购买数量，大于 0；不校验目录上下限或步进

调用示例

const result = await api.buy_pet_bath_item({
  "self_id": 123456,
  "client_type": "android",
  "pet_id": "MTIzNDU2LXBldA==",
  "item_id": "1",
  "count": 1
})

返回结果

字段	类型	说明
`result`	number	商城业务结果码，按响应返回；不限定为 0 或 1，不由框架判定业务成功
`order_id`	string	商城返回的订单号，允许为空，不修改原始文本
`submitted`	boolean	`true` 仅表示请求已提交并收到可解析的 OIDB 成功响应，不代表购买成功
`effect_verified`	boolean	`false`，框架未核验库存或购买效果

protobuf 省略 result 或 order_id 时分别返回默认值 0、""。非零业务 result、空订单号均不再使调用报错；插件自行解释业务结果。

参数错误、网络错误、无效响应或 OIDB 外层非零错误码仍使调用失败。action_result.ok=true 不代表购买业务成功；结果不确定时由调用方查询库存确认，不自动重试购买。

商城下单的商品编号在 OIDB 内层使用整数（varint）；SDK 与调试请求仍传 item_id: "1" 这样的数字字符串。count 仅校验大于 0，不预查目录上下限或步进。OIDB 外层错误（如 1000316）保持报错；业务 result 不转成异常。不会自动重试购买。