* * * * *
# （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":"私聊主動消息成功！"}]}
