# 0x02 2.和發送有關的API
>[info] 若要獲取接口的參數說明,由于API過多,建議使用 Ctrl+F 快速搜索
>[info]MPQ現已支持轉發接口,而看云則為API接口類文檔提供了一個可以在線調試的插件。
文檔中的API現已全量支持基于[轉發接口](https://f.mypcqq.cc/thread-5925.htm)的在線調試。使用方法請查看[這篇文檔](http://www.hmoore.net/mypcqq/dev-common/922252)。
請放心,看云的插件不會收集您的任何個人信息或接口信息,插件僅僅會在本地運行。點擊[這里](https://help.kancloud.cn/67539)查看官方文檔中的相關信息。
>[warning] Api_Send 均支持好友,群,討論組,群臨時會話,討論組臨時會話
>[danger] 參_消息類型:1好友,2群,3討論組,4群臨時會話,5討論組臨時會話
> 參_消息子類型:00基本 02點歌 其他不明,無特殊說明情況下留空或填零
> 參_發送群號:發送群,討論組,群臨時會話,討論組臨時會話時填寫
> 參_發送對象:發送私聊信息時填寫
[TOC]
# 多位參數的
<br />
### API在線調試
>(下方說明文本以Api_SendMsg為例,其余接口自行替換信息即可)
~~~[api]
get:http://127.0.0.1:8010/
*string:
QQ=12345#框架中登錄的QQ,如12345
API=Api_GetLog()#Api_SendMsg('12345',2,'0','66996','66996','Test')為用12345號碼向66996發送內容為“Test”的群消息
<<<
success
{"Code":"0","Msg":"OK","Data":"..."}
<<<
error
參看轉發接口說明(https://f.mypcqq.cc/thread-5925.htm)中的**狀態碼說明**部分
~~~
>Tips:將返回信息中的**Data**字段進行[base64解碼](http://tool.chinaz.com/Tools/Base64.aspx)后即可獲得真正的json信息。效果等同于在軟件內調用相關Api(在軟件內返回值即為base64解碼后的信息)。
數據類型為整數型的參數外側沒有單引號。
<br />
## [SE] Api_SendAppMsg - 發送APPMSG/JSONMSG信息
參數名稱 | 數據類型 | 描述 |
--- | --- | --- |
參_機器人QQ | 文本型 | |
參_消息類型 | 整數型 | |
參_發送群號 | 文本型 | |
參_發送對象 | 文本型 | |
參_發送內容 | 文本型 | json格式 例:{ "app": "com.tencent.weather", "desc":"天氣", "view":"RichInfoView", "ver":"0.0.0.1", "prompt":"\[應用\]天氣", "meta":{"richinfo":{"adcode":"101230604", "city":"平和", "air":"52", "min":"17", "ts":"1540009933", "wind":"1", "date":"10月20日 周六", "max":"26", "type":"201"}}, "config":{"forward":1, "autosize":0} } |
## Api_SendMsg - 向目標發送普通信息
參數名稱 | 數據類型 | 描述 |
--- | --- | --- |
參_機器人QQ | 文本型 | |
參_信息類型 | 整數型 | |
參_消息子類型 | 整數型 | |
參_發送群號 | 文本型 | |
參_發送對象 | 文本型 | |
參_發送內容 | 文本型 | |
## Api_SendMusic - 向對象發送一條音樂信息
參數名稱 | 數據類型 | 描述 |
--- | --- | --- |
參_機器人QQ | 文本型 | |
參_信息類型 | 整數型 | |
參_發送群號 | 文本型 | |
參_發送對象 | 文本型 | |
音樂_簡介 | [x] 文本型 | 留空默認‘QQ音樂 的分享’ |
音樂_播放頁面連接 | 文本型 | 任意直連或短鏈接均可 |
音樂_封面連接 | [x] 文本型 | 任意直連或短鏈接均可 例:http://url.cn/cDiJT4 |
音樂_文件直連連接 | 文本型 | 任意直連或短鏈接均可 例:http://url.cn/djwXjr |
音樂_曲名 | [x] 文本型 | |
音樂_歌手名 | [x] 文本型 | |
音樂_來源名 | [x] 文本型 | 留空默認QQ音樂 |
音樂\_來源圖標連接 | [x] 文本型 | 留空默認QQ音樂 例:http://qzonestyle.gtimg.cn/ac/qzone/applogo/64/308/100497308_64.gif |
## Api_SendObjectMsg - 向目標發送XML信息
參數名稱 | 數據類型 | 描述 |
--- | --- | --- |
參_機器人QQ | 文本型 | |
參_信息類型 | 整數型 | |
參_發送群號 | 文本型 | |
參_發送對象 | 文本型 | |
參_ObjectMsg | 文本型 | XML內容 |
參_消息子類型 | 整數型 | |
## [SE] Api_UploadGroupFile - 群文件上傳(< 500MB)
參數名稱 | 數據類型 | 描述 |
--- | --- | --- |
參_機器人QQ | 文本型 | |
參_發送群號 | 文本型 | |
文件_文件名 | 文本型 | 操作的文件名 |
文件_路徑 | [x] 文本型 | 操作的文件路徑 |
文件_數據 | [x] 字節集 | 操作的文件 |
> 文件_路徑(支持網絡鏈接) 和 文件_數據 二選一
## Api_SetNameCard - 設置群名片
參數名稱 | 數據類型 | 描述 |
--- | --- | --- |
參_機器人QQ | 文本型 | |
參_發送群號 | 文本型 | |
參_發送對象 | 文本型 | |
群_名片 | 文本型 | 操作的名片 |
## Api_SetNotice - 發群公告
參數名稱 | 數據類型 | 描述 |
--- | --- | --- |
參_機器人QQ | 文本型 | |
參_發送群號 | 文本型 | |
公告_標題 | 文本型 | 操作的標題 |
公告_內容 | 文本型 | 操作的內容 |
## Api_Shutup - 禁言群成員
參數名稱 | 數據類型 | 描述 |
--- | --- | --- |
參_機器人QQ | 文本型 | |
參_發送群號 | 文本型 | |
參_發送對象 | [x] 文本型 | 留空為全群禁言 |
禁言_時長 | 整數型 | 單位:秒 最大為1個月. 為零解除對象或全群禁言 |
## Api_UploadPic - 返回圖片GUID用于發送該圖片(圖片尺寸應小于4MB)
參數名稱 | 數據類型 | 描述 |
--- | --- | --- |
參_機器人QQ | 文本型 | |
參_上傳類型 | 整數型 | 1好友2群 注:好友圖和群圖的GUID并不相同并不通用 需要分別上傳。群、討論組用類型2 臨時會話、好友信息需要類型1 |
參_參考對象 | 文本型 | 上傳該圖片所屬的群號或QQ |
參_圖片數據 | 字節集 | 圖片字節集數據 或 字節集數據指針() |
# 三位參數的
<br />
### API在線調試
>(下方說明文本以Api_SetOLStatus為例,其余接口自行替換信息即可)
~~~[api]
get:http://127.0.0.1:8010/
*string:
QQ=12345#框架中登錄的QQ,如12345
API=Api_SendMsg('12345','2','你好~')#Api_SendMsg('12345','2','你好~')的意思為:設置12345的在線狀態為Q我吧,且附加信息為'你好~'
<<<
success
{"Code":"0","Msg":"OK","Data":"..."}
<<<
error
參看轉發接口說明(https://f.mypcqq.cc/thread-5925.htm)中的**狀態碼說明**部分
~~~
>Tips:將返回信息中的**Data**字段進行[base64解碼](http://tool.chinaz.com/Tools/Base64.aspx)后即可獲得真正的json信息。效果等同于在軟件內調用相關Api(在軟件內返回值即為base64解碼后的信息)。
數據類型為整數型的參數外側沒有單引號。
<br />
## Api_SetOLStatus - 設置在線狀態以及附加信息
參數名稱 | 數據類型 | 描述 |
--- | --- | --- |
參_機器人QQ | 文本型 | |
狀態_類型 | 文本型 | 1~6 分別對應我在線上, Q我吧, 離開, 忙碌, 請勿打擾, 隱身 |
狀態_信息 | 文本型 | 最大255字節 |
# 兩位參數的
<br />
### API在線調試
>(下方說明文本以Api_AddTaotao為例,其余接口自行替換信息即可)
~~~[api]
get:http://127.0.0.1:8010/
*string:
QQ=12345#框架中登錄的QQ,如12345
API=Api_AddTaotao('12345','你好~')#Api_AddTaotao('12345','你好~')的意思為:使用12345的賬戶發送一條說說,內容為“你好~”。
<<<
success
{"Code":"0","Msg":"OK","Data":"..."}
<<<
error
參看轉發接口說明(https://f.mypcqq.cc/thread-5925.htm)中的**狀態碼說明**部分
~~~
>Tips:將返回信息中的**Data**字段進行[base64解碼](http://tool.chinaz.com/Tools/Base64.aspx)后即可獲得真正的json信息。效果等同于在軟件內調用相關Api(在軟件內返回值即為base64解碼后的信息)。
數據類型為整數型的參數外側沒有單引號。
<br />
## Api_GetCookiesByDomain - 根據子業務域名取得Cookies
參數名稱 | 數據類型 | 描述 |
--- | --- | --- |
參_機器人QQ | 文本型 | |
業務_域名 | 文本型 | QQ的業務域名 例: v.qq.com |
## Api_CancelGroupMsgA - 撤回群信息(需要群管)
參數名稱 | 數據類型 | 描述 |
--- | --- | --- |
參_機器人QQ | 文本型 | |
參_原始信息 | 文本型 | Event函數中的'參_原始信息' 經過解密后的封包字節數據 |
## Api_AddTaotao - 發說說
參數名稱 | 數據類型 | 描述 |
--- | --- | --- |
參_機器人QQ | 文本型 | |
參_發送內容 | 文本型 | |
## Api_SendShake - 向好友發送窗口抖動信息
參數名稱 | 數據類型 | 描述 |
--- | --- | --- |
參_機器人QQ | 文本型 | |
參_發送對象 | 文本型 | |
## Api_SendTyping - 向好友發送‘正在輸入’的狀態信息
參數名稱 | 數據類型 | 描述 |
--- | --- | --- |
參_機器人QQ | 文本型 | |
參_發送對象 | 文本型 | |
## Api_SetSign - 設置個簽
參數名稱 | 數據類型 | 描述 |
--- | --- | --- |
參_機器人QQ | 文本型 | |
參_發送內容 | 文本型 | |
## Api_Tea加密 - tean加密算法
參數名稱 | 數據類型 | 描述 |
--- | --- | --- |
參_加密內容 | 文本型 | |
參_Key | 文本型 | |
## Api_Tea解密 - tean解密算法
參數名稱 | 數據類型 | 描述 |
--- | --- | --- |
參_解密內容 | 文本型 | |
參_Key | 文本型 | |
## Api_Send - 發送封包
參數名稱 | 數據類型 | 描述 |
--- | --- | --- |
參_機器人QQ | 文本型 | |
參_封包內容 | 文本型 | |
# 一位參數的
## [SE] Api_DeleteQQ - 從框架中刪除QQ
參數名稱 | 數據類型 | 描述 |
--- | --- | --- |
參_機器人QQ | 文本型 | |
>[info]編寫:蘇蘇
>潤色:a632079 & 斯米拉
>審核:Eghuai
>最后更新:2019.1.20