上行回复
一、接口地址
https://sms-api.luosimao.com/v1/incoming.[json|xml]
后缀表示可选的返回值格式。
二、HTTP请求方式
GET
三、请求参数
| 名称 | 类型 | 是否必须 | 默认值 | 示例值 | 描述 |
|---|---|---|---|---|---|
| start | Timestamp | 否 | 24小时前 | 1381757021 | 回复的开始时间 |
| end | Timestamp | 否 | 当前时间戳 | 1381756984 | 回复的结束时间 |
| page | Number | 否 | 1 | 2 | 页码 |
| page_size | Number | 否 | 10 | 20 | 单页的返回条数 |
四、返回结果
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| error | Number | 0 | 错误码 |
| msg | String | "ok" | 提示信息 |
| list | List | [{"mobile":"18017492720","content":"一步伐","send_time":"2013-10-12 15:18:17"}] | 短信列表（结构见下方说明） |
| total | Number | 1 | 区间内的回复短信总条数 |
list item 结构说明：
| 字段名 | 描述 |
|---|---|
| mobile | 手机号 |
| message | 回复内容 |
| send_time | 发送时间 |
五、返回示例
JSON格式：
{
"error": 0,
"msg": "ok",
"page": 1,
"page_size": 10,
"list": [
{
"mobile": "18017492720",
"content": "一步伐",
"send_time": "2013-10-12 15:18:17"
}
],
"total": 1
}
XML格式：
<?xml version="1.0" encoding="utf-8"?>
<response>
<error>0</error>
<msg>ok</msg>
<page>1</page>
<page_size>10</page_size>
<list>
<mobile>13761428268</mobile>
<content>测试个回复</content>
<send_time>2013-10-09 11:12:19</send_time>
</list>
<list>
<mobile>13761428268</mobile>
<content>测试一条</content>
<send_time>2013-10-10 11:13:37</send_time>
</list>
<total>2</total>
</response>
六、错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| -10 | 验证信息失败 | 检查API Key是否与管理中心一致 |