# 0x02 API
[TOC]
## 私聊
## 多人
## 框架
任務ID:1
示例:
## Api_Ban
1、描述
本API可以將指定QQ列入QQ黑名單。
2、參數
| ID | 參數名稱 | 數據類型 | 描述 |
| --- | --- | --- | --- |
| 1 | 響應的QQ | 文本型 | 機器人QQ |
| 2 | QQ | 文本型 | 要加黑的QQ |
3、返回類型:無 (void)
4、注意
加黑后,這個家伙將出現在這里(PCQQ):

您和對方之間無法進行任何操作。如果需要移出黑名單,您可以使用 Api_DBan 。
5、Example #1 加黑某個QQ

<br /><br /><br /><br /><br /><br /><br />
## Api_DBan
1、描述
本API可以將指定QQ移除QQ黑名單。
2、參數
| ID | 參數名稱 | 數據類型 | 描述 |
| --- | --- | --- | --- |
| 1 | 響應的QQ | 文本型 | 機器人QQ |
| 2 | QQ | 文本型 | 要加黑的QQ |
3、返回類型:無 (void)
4、注意
在執行這個操作之前,您無法和對方進行任何溝通或者操作。
5、Example #1 將某個QQ移出黑名單

<br /><br /><br /><br /><br /><br /><br />
## Api_GetGtk_Bkn
1、描述
本API可以根據提交的QQ號計算得到頁面操作用參數Bkn或G_tk
2、參數
| ID | 參數名稱 | 數據類型 | 描述 |
| --- | --- | --- | --- |
| 1 | 機器人QQ|文本型 | 機器人QQ |
3、返回類型:文本型
返回Bkn,可用于各種頁面操作。
>[info] **Q:** Gtk(G\_tk)和Bkn是什么東西?
>**A:** 騰訊的頁面(網頁)操作令牌。目前這兩個參數的值和算法都是一樣的。
千萬不要小看這兩個參數的作用。如果沒有這兩個參數,涉及賬戶信息的頁面操作幾乎全部會失敗。登陸后獲得的Cookie里面也會回傳這個參數。
4、Example #1 調用示例:

<br /><br /><br /><br /><br /><br /><br />
## Api_GetOnlineQQlist
1、描述
本API可以取得框架內所有在線的QQ的列表。
2、參數
本API不需要其他參數。
3、返回類型:文本型
取得框架內在線的QQ列表。以換行符分割,每行一個。
例如:
28934444
7894561
1237895
4、注意
此API只獲取已經登錄了的QQ,不獲取框架內未登錄QQ。如需獲取全部,請使用 Api_GetQQlist() 。
5、Example #1 循環輸出所有在線的QQ

<br /><br /><br /><br /><br /><br /><br />
## Api_GetQQlist
1、描述
本API可以取得框架內所有QQ列表。包括未登錄以及登錄失敗的QQ。
2、參數
本API不需要其他參數。
3、返回類型:文本型
取得框架內所有QQ列表。包括未登錄以及登錄失敗的QQ。以換行符分割,每行一個。
例如:
28934444
7894561
1237895
4、注意
此API不判斷是否已登錄。如果需要只獲取已登錄QQ,可用 Api_GetOnlineQQlist()。使用方法幾乎相同。
5、Example #1 循環輸出所有已經在框架里的QQ

<br /><br /><br /><br /><br /><br /><br />
## Api_OutPut
1、描述
本API可以在框架的日志列表輸出一行東西。
2、參數
| ID | 參數名稱 | 數據類型 | 描述 |
| --- | --- | --- | --- |
| 1 | 內容|文本型 | 要輸出的內容|
3、返回類型:整數型
返回的整數型數據并沒有什么卵用,一直是0.
4、注意
這個API可以輸出給用戶的提示信息,也可以用于下斷點調試。
5、Example #1 調用示例:

效果:

>[info]編寫:freejishu
>潤色:a632079 & 斯米拉
>審核:Eghuai
>最后更新:2016.06.18