《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.snjht.com/jiaocheng/14497.html