个人微信号二次开发API调用、微信API接口

微信API接口、微信二次开发API调用

微信协议接口调用-加微信好友及通过好友请求

 

搜索

小提示：

• 添加联系人必要接口
• 搜索返回的V3 V4用于添加联系人

请求URL：

• http://域名地址/api/contacts/search

请求方式：

• POST

请求头：

• Content-Type：application/json

• X-GEWE-TOKEN: 后台获取

参数：

参数名	必填	数据类型	说明
appid	是	string	设备id
user_name	是	string	搜索的手机号/微信号

返回数据：

参数名	数据类型	说明
ret	number	0：成功
msg	string	反馈信息
data	object
data.UserName	object	用户名 添加好友凭证1 （如果是好友返回id 非好友是凭证）
data.NickName	object	用户昵称
data.Province	string	省份
data.City	string	市区
data.Country	string	国家
data.Signature	string	个性签名
data.Sex	string	性别 1、男 2、女
data.BigHeadImgUrl	string	大头像
data.SmallHeadImgUrl	string	小头像
data.AntispamTicket	string	添加好友凭证2

请求参数示例：

   {
       "appid": "wx_nScLwnZhfNmlQlL0npc71",
       "user_name": "18761670817",
   }

成功返回示例：

{
    "ret": 0,
    "msg": "success",
    "data": {
        "BaseResponse": {
            "ret": 0,
            "errMsg": {
                "string": "Everything is OK"
            }
        },
        "UserName": {
            "string": "v3_020b3826f。。。。。。"
        },
        "NickName": {
            "string": "张三"
        },
        "Pyinitial": {
            "string": "wxid_bo6akbwms8rv12"
        },
        "QuanPin": {
            "string": "wxid_bo6akbwms8rv12"
        },
        "Sex": 2,
        "ImgBuf": {
            "iLen": 0
        },
        "Province": "Anhui",
        "City": "MOS",
        "Signature": "默默无闻。。",
        "PersonalCard": 1,
        "VerifyFlag": 0,
        "WeiboFlag": 0,
        "AlbumStyle": 0,
        "AlbumFlag": 3,
        "SnsUserInfo": {
            "SnsFlag": 0,
            "SnsBgobjectId": 0,
            "SnsFlagEx": 0
        },
        "Country": "CN",
        "MyBrandList": "<brandlist count=\"0\" ver=\"841173559\"></brandlist>",
        "CustomizedInfo": {
            "BrandFlag": 0
        },
        "ContactCount": 0,
        "BigHeadImgUrl": "http://123456",
        "SmallHeadImgUrl": "http://456789",
        "ResBuf": {
            "iLen": 0
        },
        "AntispamTicket": "v4_000b708f0b040。。。。。。。。",
        "MatchType": 2
    }
}

• 如果是好友 UserName字段显示的是id AntispamTicket为空
  非好友的情况 可以根据 UserName以及 AntispamTicket 作为添加好友的凭证

错误返回示例：

    {
        "ret": -1,
        "msg_err": "[wx_bpPSNW0kK0xYSM6ldubd]设备不存在或已离线"
    }

好友请求验证

小提示：

• v_3   v_4 可以参考 搜索接口

请求URL：

• http://域名地址/api/contacts/verifyuser

请求方式：

• POST

请求头：

• Content-Type：application/json

• X-GEWE-TOKEN: 后台获取

  参数：

参数名	必填	数据类型	说明
appid	是	string	设备id
config	否	object	其他配置
config.card_nickname	否	string	昵称
config.card_username	否	string	用户id
config.group_id	否	string	群id 如果是群加好友 必填
content	否	string	申请语
opcode	是	number	2添加好友 3同意好友 4拒绝好友
scene	是	number	添加方式 3 ：微信号搜索 4 ：QQ好友 8 ：来自群聊 15：手机号
v_3	是	string	添加好友凭证1
v_4	是	string	添加好友凭证2

返回数据：

参数名	数据类型	说明
ret	number	0：成功
msg	string	反馈信息

请求参数示例：

  {
      "appid": "wx_nScLwnZhfNmlQlL0npc71",
      "config": {
          "card_nickname": "",
          "card_username": "",
          "group_id": ""
      },
      "content": "",
      "opcode": 0,
      "scene": 3,
      "v_3": "v3_0000000sdasda.......",
      "v_4": "v4_13910381083........"
  }

成功返回示例：

  {
      "ret": 0,
      "msg": "success",
      "data": {
          "BaseResponse": {
              "ret": 0,
              "errMsg": {}
          }
      }
  }

错误返回示例：

{
    "ret": 0,
    "msg": "success",
    "data": {
        "BaseResponse": {
            "ret": -2,
            "errMsg": {
                "string": "Invalid argument"
            }
        }
    }
}