查询使用流量

查询当前开发者账号下在线微信实例的流量消耗情况。

接口地址： POST /getUserFlow

前置条件

• 当前开发者账号已完成接口鉴权。
• 账号下存在在线微信实例；无在线实例时列表可能为空。

请求参数

无需请求参数。

请求示例

{}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	array	流量统计列表
data[].account	string	开发者账号
data[].nickName	string	微信昵称
data[].wcId	string	微信 ID
data[].flow	string	使用流量展示值，如 262MB
data[].size	number	使用流量字节数
data[].wid	string	登录实例标识

成功响应

{
  "code": "1000",
  "message": "处理成功",
  "data": [
    {
      "account": "1875323779",
      "nickName": "小叶子",
      "wcId": "wxid_2hq3u6nrd822",
      "flow": "262MB",
      "size": 274971864,
      "wid": "7cee86c5-5275-43ec-f1-aa38f9589083"
    }
  ]
}

错误响应

{
  "code": "1001",
  "message": "失败",
  "data": null
}

使用建议

• 对账或成本统计时建议使用 size 字节数计算，flow 适合展示。
• 流量统计与在线实例相关，离线实例可能不在当前返回列表中。
• 如果某个实例流量异常升高，建议结合接口调用次数一起排查。