动作提交
## 动作提交
API跳转: [`数据库操作`](#_390) [`文件操作`](#_492)
### 提交要求
>i 动作上报需以`action`为参数,如有数据返回<向插件获取QQ内的数据>需加上`code`参数,值自定义即可,在插件获取到数据后会以事件`return_data`携带数据和`code`参数发送到客户端。
---
### 动作类型
`逻辑型`如果存在值则为`真`,反之则为`假`
>s 发送消息:`send_msg`
发送json消息:`send_jsonMsg`
发送xml消息:`send_xmlMsg`
>s ☀ 消息接受图片/语音/视频,格式为:[`type`,`content`数据], type有 `image`/`voice`/`video`/`file`/`#[0-8]` 五种类型,content有:`base64:`/`http`/`file=`/`$` 四种格式,数据即为不同格式对应数据,其中base64不需要前缀,视频及群文件仅支持`file=文件路径`的形式,`#`标注的类型只支持`$`的形式,并且唯一。
`#` 类型详细说明,请参见 **附录**。
|参数|类型|说明|附加
|-|-|-|-
|uid|长整数型|发送到QQ|仅好友
|gid|长整数型|发送到群|仅群
|msg|文本型|发送内容
|anonymous|逻辑型|是否匿名|仅群 / 可空
<br>
>w 添加好友/群:`add`
|参数|类型|说明|附加
|-|-|-|-
|uid|长整数型|添加的QQ|仅好友
|nickname|文本型|备注名|仅好友
|gid|长整数型|添加的群|仅群
|answer|文本型|问题答案
<br>
>d 设置昵称/群名片:`set_nickname`
|参数|类型|说明|附加
|-|-|-|-
|uid|长整数型|添加的QQ|仅群
|gid|长整数型|添加的群|仅群
|msg|文本型|需要修改成的昵称
<br>
>i 分享音乐:`share_music`
|参数|类型|说明|附加
|-|-|-|-
|to|长整数型|分享对象|QQ/群号
|name|文本型|歌曲名
|singer|文本型|歌手名
|linkUrl|文本型|跳转地址
|imageUrl|文本型|封面地址
|fileUrl|文本型|文件地址
|appType|整数型|应用类型|
|shareType|整数型|分享类型|私聊0/群聊1
|appType|说明
|-|-
|0|QQ音乐
|1|虾米音乐
|2|酷我音乐
|3|酷狗音乐
|4|网易云音乐
<br>
>s 发送群公告:`send_groupNotice`
|参数|类型|说明|附加
|-|-|-|-
|gid|长整数型|群号
|title|文本型|标题
|msg|文本型|内容
|isPopup|逻辑型|是否弹窗|可空
|isOk|逻辑型|是否需要确认|可空
|isTop|逻辑型|是否置顶|可空
|isSendNewMember|逻辑型|是否发送给新成员|可空
|isChangeNickname|逻辑型|是否引导修改昵称|可空
<br>
>w 发送群临时消息:`send_groupTemp`
|参数|类型|说明|附加
|-|-|-|-
|uid|长整数型|目标QQ
|gid|长整数型|群号
|msg|文本型|发送内容
<br>
>d 发送红包:`send_redPacket`
|参数|类型|说明|附加
|-|-|-|-
|uid|长整数型|目标QQ|仅好友
|gid|长整数型|发送到群|仅群
|type|整数型|红包类型|可空
|msg|文本型|对应红包内容
|num|整数型|数量
|money|整数型|金额
|password|文本型|支付密码
|to|文本型|领取人|仅专属
|isAverage|逻辑型|是否均分|仅专属 / 可空
|说明|type|msg
|-|-|-|
|口令红包|1|口令
|接龙红包|2|接龙内容
|画图红包|3|题目名
|语音红包|4|语音口令
|专属红包|5|祝福语
|普通红包|默认|祝福语
<br>
>i 文件转发:`relay_file`
|参数|类型|说明|附加
|-|-|-|-
|uid|长整数型|转发至QQ
|gid|长整数型|转发至群
|fromQQ|长整数型|来源QQ
|fromGroup|长整数型|来源群
|fileId|文本型|文件id
|fileName|文本型|文件名|仅转发至QQ
|fileSize|长整数型|文件大小|仅转发至QQ
暂不支持 `好友文件转发至群`
<br>
>s 获取key值:`get_key`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|domain|文本型|域|可空
<br>
>w 登录网页获取cookie值:`get_ck`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|callbackUrl|文本型|回调跳转地址
|appid|文本型|应用id
|daid|文本型|daid值
<br>
>d 取cookie值:`get_cookie`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|skey|文本型|skey值
|pskey|文本型|pskey值
<br>
>i 点赞:`liked`
|参数|类型|说明|附加
|-|-|-|-
|uid|长整数型|需点赞的QQ
<br>
>s 保存文件至微云:`save_toCloud`
|参数|类型|说明|附加
|-|-|-|-
|gid|长整数型|群号
|fileId|文本型|文件id
<br>
>w 查询好友/群信息:`query_data`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|gid|长整数型|群号|仅群
|uid|长整数型|好友QQ|仅好友
<br>
>d 撤回私聊/群信息:`withdraw`
|参数|类型|说明|附加
|-|-|-|-
|gid|长整数型|群号|仅群
|uid|长整数型|好友QQ|仅私聊
|random|长整数型|random值
|req|整数型|req值
|time|整数型|消息接收时间|仅私聊
<br>
>i 处理好友/群验证事件:`verify`
|参数|类型|说明|附加
|-|-|-|-
|gid|长整数型|群号|仅群
|uid|长整数型|好友QQ
|seq|长整数型|seq值
|operateType|整数型|操作类型|同意11/拒绝12/忽略14
|eventType|整数型|事件类型|自助3/邀请25
|msg|文本型|拒绝理由|可空
<br>
>s 创建群文件夹:`folder`
|参数|类型|说明|附加
|-|-|-|-
|gid|长整数型|群号
|folderName|文本型|文件夹名
<br>
>w 拨打QQ电话:`call`
|参数|类型|说明|附加
|-|-|-|-
|uid|长整数型|好友QQ
<br>
>d 发送免费礼物:`send_gift`
|参数|类型|说明|附加
|-|-|-|-
|gid|长整数型|群号
|uid|长整数型|好友QQ
|gifId|整数型|礼物id
<br>
>i 邀请好友/群友入群:`invite_toGroup`
|参数|类型|说明|附加
|-|-|-|-
|gid|长整数型|目标群号
|uid|长整数型|好友QQ
|fromGroup|长整数型|来源群号|可空
<br>
>s 上传群文件 - 不支持上百M文件:`upload_file`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|gid|长整数型|目标群号
|path|文本型|文件路径
|fileName|文本型|文件名
<br>
>w 取群列表:`get_groupList`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
<br>
>d 取好友列表:`get_friendList`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
<br>
>i 取群成员列表:`get_memberList`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|gid|长整数型|群号
<br>
>s 取群管理列表:`get_adminList`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|gid|长整数型|群号
<br>
>w 取群文件列表:`get_fileList`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|gid|长整数型|群号
|folder|文本型|文件夹名|可空
<br>
>d 取群员数据:`get_memberData`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|gid|长整数型|群号
|uid|长整数型|群员QQ
<br>
>i 取链接:`get_url`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|gid|长整数型|群号|唯一表加群链接
|imgCode|文本型|图片代码|仅图片 / 群号可空
|fileId|文本型|文件id|仅文件
|fileName|文本型|文件名|仅文件
<br>
>s 取好友在线状态:`get_friendState`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|uid|长整数型|好友QQ
<br>
>w 取群名片:`get_groupCard`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|gid|长整数型|群号
|uid|长整数型|群员QQ
<br>
>d 设置群名片:`set_groupCard`
|参数|类型|说明|附加
|-|-|-|-
|gid|长整数型|群号
|uid|长整数型|群员QQ
|msg|文本型|新名片
<br>
>i 设置管理员:`set_admin`
|参数|类型|说明|附加
|-|-|-|-
|gid|长整数型|群号
|uid|长整数型|群员QQ
|isCancel|逻辑型|是否取消|可空
<br>
>s 设置成员头衔:`set_memberTitle`
|参数|类型|说明|附加
|-|-|-|-
|gid|长整数型|群号
|uid|长整数型|群员QQ
|msg|文本型|头衔
<br>
>w 设置在线状态:`set_onlineState`
|参数|类型|说明|附加
|-|-|-|-
|main|整数型|
|sun|整数型|
|battery|整数型|
<br>
>d 设置地理位置 - 需3s设置一次否则将关闭:`set_geoPosition`
|参数|类型|说明|附加
|-|-|-|-
|gid|长整数型|群号
|x|双精度小数型|纬度
|y|双精度小数型|经度
|isOpen|逻辑型|是否开启
<br>
>i 删除文件/文件夹/群/群员/好友:`del`
|参数|类型|说明|附加
|-|-|-|-
|gid|长整数型|群号
|uid|长整数型|目标QQ
|folder|文本型|文件夹名|可空
|fileId|文本型|文件id|仅文件
|forever|逻辑型|永久拒绝入群|仅删群员 / 可空
<br>
>s 双击头像:`dblclick`
|参数|类型|说明|附加
|-|-|-|-
|gid|长整数型|群号
|uid|长整数型|目标QQ
<br>
>w 群员/全体禁言:`noSpeak`
|参数|类型|说明|附加
|-|-|-|-
|gid|长整数型|群号
|uid|长整数型|群员QQ|仅群员
|time|整数型|时长|仅群员
|isAll|逻辑型|全体禁言|仅全体
<br>
>d 取昵称:`get_nickname`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|uid|长整数型|目标QQ
<br>
#### 数据库操作
>i 打开数据库:`db_open`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|path|文本型|文件路径
<br>
>s 获取所有表:`db_getTables`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
<br>
>w 载入表:`table_load`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|msg|文本型|表名
<br>
>d 取表所有数据:`table_getAll`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
<br>
>i 取表下某字段的所有值:`table_getKey`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|msg|文本型|字段名
<br>
>s 以某字段为参考重新排列所有行:`table_sort`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|sort|整数型|排序方式|默认: 从小到大, -1: 从大到小
|key|文本型|字段名
|limit|整数型|跳过多少行
|slice|整数型|截取多少行
<br>
>w 修改表<`键值表数组`>:`table_edit`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|key|文本型|字段名
|v|文本型|改变的值
|i|整数型|行号
<br>
>d 插入数据<`键值表数组`>:`table_insert`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|key|文本型|字段名
|v|文本型|添加的值
<br>
>i 确认表的修改:`table_upload`
取消表的修改:`table_cancel`
进入编辑模式:`table_openEdit`
|参数|类型|说明|附加
|-|-|-|-
<br>
>s 删除某行:`table_delLine`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|msg|整数型|行号
<br>
>w 创建表:`table_create`
初始化表:`table_init`
|参数|类型|说明|附加
|-|-|-|-
|msg|整数型|表名
<br>
>d 初始化表:`table_init`
|参数|类型|说明|附加
|-|-|-|-
|msg|整数型|表名
<br>
#### 文件操作
>i 读取文件:`file_read`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|path|文本型|文件名
<br>
>s 读取文本行:`file_readLine`
|参数|类型|说明|附加
|-|-|-|-
|code|文本型|参照
|path|文本型|文件名
|msg|整数型数组|索引数组
<br>
>w 替换文件内容:`file_write`
|参数|类型|说明|附加
|-|-|-|-
|path|文本型|文件名
|msg|文本型|替换内容
<br>
>d 编辑文本行:`file_editLine`
>d☀ 行号前加`^`表示在行前添加数据,`$`表示在行后添加数据,替换内容若为空则删除此行
|参数|类型|说明|附加
|-|-|-|-
|path|文本型|文件名
|msg|文本数组|替换列表|偶数索引:行号, 奇数索引:替换内容
<br>
>i 在文件末尾追加文本:`file_append`
|参数|类型|说明|附加
|-|-|-|-
|path|文本型|文件名
|msg|文本型|追加的文本
<br>