vbot微信机器人操作联系人的API（1）通用API

《vbot微信机器人操作联系人的API（1）通用API》要点：
本文介绍了vbot微信机器人操作联系人的API（1）通用API，希望对您有用。如果有疑问，可以联系我们。

相关主题：web微信和微信机器人

本节要讲使用PHP的vbot开发微信机器人，操作微信联系人号。

一、获取联系人实例：

// 好友实例
$friends = vbot('friends');
// 群实例
$groups = vbot('groups');
// 群成员实例
$members = vbot('members');
// 公众号实例
$officials = vbot('officials');
// 特殊账号实例
$specials = vbot('specials');
// 获取自己实例
$myself = vbot('myself');

二、vbot微信机器人操作联系人API——通用API部分：

通用API是指即可以用于微信好友，也可以用于微信群的操作。后面还有其它不可通用的API。

【参数说明】$blur 是否模糊搜索

下面方法中，会有一个$blur参数，默认是false，表示API的方法，默认是精确搜索。

如果你把blur设置为true，则搜索使用模糊搜索，比如搜“维易”，那么不管是“PHP维易”，还是“维易PHP”都会搜到。

【主要功能】

查找username，并根据username获取用户详细信息，或取得它的头像。

（1）根据昵称获取对象

$username = $friends->getUsernameByNickname($nickname, $blur = false);

（2）根据备注获取对象

$username = $friends->getUsernameByRemarkName($remark, $blur = false);

（3）指定键搜索其UserName：

search 为搜索的词，key 为要搜索的键。上面两个方法，其实是这方法的变体。

$friends->getUsername($search, $key, $blur = false);

实例：

$userName = $friends->getUsername ( '高', 'NickName', true );

附：上面两个方法，其实是这方法的变体，看下面的源码内部实现方式：

public function getUsernameByNickname($nickname, $blur = false)
{
       return $this->getUsername($nickname, 'NickName', $blur);
}

（4）根据 UserName 获取联系人：

当你想得到该 username 具体信息时可使用：

    $friends->getAccount($username);

此方法等同于：

    $groups->get($username);

一般建议根据类型选择get，二者是一样的，如：

$re1 = $friends->getAccount ( $username );
$re2 = $friends->get($username);   #和getAccount一样

（5）获取头像：

$data = $groups->getAvatar($username);

file_put_content('avatar.jpg', $data);

下一节讲好友API

转载请注明本页网址：
http://www.vephp.com/jiaocheng/14497.html