接口说明

• 接口路径：http://127.0.0.1:7777/qianxun/httpapi
• 请求方法：POST
• 功能描述：查询陌生人信息

微信版本支持情况

提示

❌ 3.9.9.34

✅ 3.9.10.16

✅ 3.9.11.18

✅ 3.9.12.16

✅ 3.9.12.44

✅ 3.9.12.54

✅ 3.9.12.56

Query请求参数

参数	类型	必填	说明
safekey	string	否	安全秘钥，未设置的话则不需要传
wxid	string	是	要使用哪个微信机器人的wxid

Body请求参数

参数	类型	必填	说明
type	string	是	接口type
data	object	是	请求数据对象
data.obj	string	是	对方信息（QQ或者手机号或者微信号）

Body请求示例

{
    "type": "queryNewFriend",
    "data": {
        "obj": "1330166564"
    }
}

响应参数

参数	类型	说明
code	integer	响应码
msg	string	响应消息
wxid	string	微信ID
port	integer	端口
pid	integer	进程ID
flag	string	标志
timestamp	string	时间戳
result	object	结果对象
result.ret	string	返回状态
result.phone	string	手机号
result.wxid	string	微信ID
result.nick	string	昵称
result.v3	string	V3数据
result.v4	string	V4数据
result.sign	string	个性签名
result.country	string	国家
result.province	string	省份
result.city	string	城市
result.avatarMinUrl	string	头像小图URL
result.avatarMaxUrl	string	头像大图URL
result.sex	string	性别（0=未知，1=男，2=女）

响应示例

{
    "code": 200,
    "msg": "操作成功",
    "result": {
        "ret": "1",
        "phone": "",
        "wxid": "wxid_igou083v5qgp22",
        "nick": "柯南",
        "v3": "v3_020b3826fd030100000000007b4c2d89757d15000000501ea9a3dba12f95f6b60a0536a1adb6443c5bb8c2efda9a0e3081c0adb1aa270cfe5d9222867e0dde6640e9db64eed9caaf13b0d56b7600f61eb5bfd2b71221ac4cd728d7c28d3c151b1d4747@stranger",
        "v4": "",
        "sign": "",
        "country": "CN",
        "province": "Guangdong",
        "city": "Guangdong",
        "avatarMinUrl": "http://wx.qlogo.cn/mmhead/ver_1/5H837U83NjRC6NTmic3biaf07dpNTm9micm9gc6kMypYzC5j3F1Q9Wv8MvNtic0TTOfDjV1IAIWZPPGLficToKWN7ALCKUtSq10vSk8FUgjFAbz0/132",
        "avatarMaxUrl": "http://wx.qlogo.cn/mmhead/ver_1/5H837U83NjRC6NTmic3biaf07dpNTm9micm9gc6kMypYzC5j3F1Q9Wv8MvNtic0TTOfDjV1IAIWZPPGLficToKWN7ALCKUtSq10vSk8FUgjFAbz0/0",
        "sex": ""
    },
    "wxid": "wxid_nq6r0w9v12612",
    "port": 8888,
    "pid": 32236,
    "flag": "7888",
    "timestamp": "1717080783280"
}