# 0x02 2.和发送有关的API
>[info] 若要获取接口的参数说明,由于API过多,建议使用 Ctrl+F 快速搜索
>[info]MPQ现已支持转发接口，而看云则为API接口类文档提供了一个可以在线调试的插件。
文档中的API现已全量支持基于[转发接口](https://f.mypcqq.cc/thread-5925.htm)的在线调试。使用方法请查看[这篇文档](https://www.kancloud.cn/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
