* * * * *
# (1)消息输入接口:
## 接口名称
### 1) 请求地址
>http://www.xxx.com/inputmsg.php
### 2) 调用方式:HTTP post
### 3) 接口描述:
* 接口描述详情
### 4) 请求参数:
```
{
"content": "消息内容",
"category": "分类名称"
}
```
#### POST参数:
|字段名称 |字段说明 |类型 |必填 |备注 |
| -------------|:--------------:|:--------------:|:--------------:| ------:|
|content|消息内容|string|Y|-|
|category|分类名称|string|Y|-|
### 5) 请求返回结果:
```
写入资源池成功!
```
```
写入资源池失败!
```
```
参数为空!
```
* * * * *
# (2)机器人被动触发接口:
## 接口名称
### 1) 请求地址
>http://www.xxx.com/api.php
### 2) 调用方式:HTTP post
### 3) 接口描述:
* 群内成员或好友发送消息,触发机器人回复。
### 4) 请求参数:
|名称|类型|说明|
| --- | --- | --- |
|mode|string| 1:群聊触发;2:私聊触发;3:定时消息;8:微信退出登录;9:PC微信程序关闭;0:微信登录|
|iuname| string | 机器人账号 |
|robotid| string | 机器人wxid |
|robotname| string | 机器人昵称 |
|gid|string | 群聊:群chatroomid;私聊:好友wxid |
|gname| string | 群聊:群名称;私聊:好友备注 |
|username| string | 群聊:群成员wxid;私聊:好友wxid |
|nickname| string | 群聊:群成员昵称;私聊:好友昵称 |
|isadmin| int | 群聊:是否是群管理员;私聊:是否是全局管理员 |
|msgtype| int | 消息类型。1:文本消息;10000:系统消息;3:图片消息;47:表情消息;42:名片消息;34:语音消息;43:视频消息;49:链接消息(小程序,私聊转账消息,邀请进群消息);37:加好友消息 |
|msgid| string | 消息唯一id |
|content| string | 消息内容 |
|atwxid| string | 群聊:@对象的wxid,多个逗号分隔;私聊:无 |
|membernum| string | 群聊:群人数;私聊:无 |
### 5) 请求返回结果:
JSON示例:{"code":"10001","text":"发送消息成功!","towxid":"wxid_123456789"}
注:towxid可省略,默认为@触发消息的群成员。
# (3)机器人主动消息接口:
## 接口名称
### 1) 请求地址
>http://www.xxx.com/api.php
### 2) 调用方式:HTTP post
### 3) 接口描述:
* 机器人主动发送消息(从资源池读取消息队列)
### 4) 请求参数:
| 参数 | 必填 | 说明 |
| --- | --- | --- |
| delaytime | 是 | 每条消息的间隔时间 |
| list | 是 | 消息列表,数组格式 |
| wxid | 是 | 目标id,群chatroomid或者好友wxid |
| code | 是 | 参考触发型消息code定义 |
| text | 是 | 消息内容或者欲踢出群成员wxid或者邀请群chatroomid |
| towxid | 否 | 群内@效果的对象的wxid |
### 5) 请求返回结果:
JSON示例:{"delaytime":"1000","list":[{"wxid":"1451900082@chatroom","code":"10001","text":"群聊主动消息成功!","towxid":"wxid_123456789"},{"wxid":"wxid_1234567890123","code":"20001","text":"私聊主动消息成功!"}]}