發送 · MyPCQQ開發者入門

# 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] # 多位參數的 ### 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解碼后的信息）。數據類型為整數型的參數外側沒有單引號。 ## [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 | 參_圖片數據 | 字節集 | 圖片字節集數據或字節集數據指針() | # 三位參數的 ### 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解碼后的信息）。數據類型為整數型的參數外側沒有單引號。 ## Api_SetOLStatus - 設置在線狀態以及附加信息參數名稱 | 數據類型 | 描述 | --- | --- | --- | 參_機器人QQ | 文本型 | | 狀態_類型 | 文本型 | 1~6 分別對應我在線上, Q我吧, 離開, 忙碌, 請勿打擾, 隱身 | 狀態_信息 | 文本型 | 最大255字節 | # 兩位參數的 ### 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解碼后的信息）。數據類型為整數型的參數外側沒有單引號。 ## 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