# 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