1.HTTP
1.1全局规范
URL
URL的组成：基本的网络地址 ＋ 分支节点
http://172.19.201.155/iqasweb/ 为 基本的网络地址
/login 为 分支节点
http://172.19.201.155:8443/datasyn/login 组成完整的 URL
当前统一的基本网络地址为 http://172.19.201.155/iqasweb/请求方式
|POST
|GET请求消息头
请求参数
键值对(key value形式)
默认都是必选参数请求参数
键值对(key value形式)响应的状态码
统一的返回码为: 200 (注:只要访问服务器成功，一律返回200)响应的格式
Json响应的JSON规范
成功
{
"status": 1,
"message": "",
"data": ...
}
成功的标记为 status为 1
根据具体的请求，如果需要返回值 data节点 包含的是 返回结果
不需要需要返回值 ，则没有data节点
- 失败
{
"status": 错误编码,
"message": "错误原因",
"data": null
}
失败的标记为 status为 除1以外的其它编码
status不为1时，message为错误原因
1.2目前包含资源
包含4年级和5年级单词
5年级目前只包含apple一个单词及其相关资源
2. 获取离线包下载链接接口
- 分支节点 :
/mobile/offline/getOffLineBag4ios.html - 请求方式 :
POST - 请求参数
| key | 类型 | 说明 |
|---|---|---|
| realGrade | int | 实际年级 |
| themenumber | String | 主题编号，如2-12 |
- 响应结果 :
- 成功
{
"status": 1,
"message": "",
"data": [
{
"id": "2482bcd23802eb0a26b3d9ff5d4da6cc",
"name": "ios-2-12-4-3",
"downUrl": "mobile/offline/downofflinebag.html"
},
{
"id": "f67b9675f6593df5c7293aa8edd99fbe",
"name": "ios-2-12-4-4",
"downUrl": "mobile/offline/downofflinebag.html"
},
{
"id": "c7115a5c84119aa2d3106aa04f034591",
"name": "ios-2-12-4-5",
"downUrl": "mobile/offline/downofflinebag.html"
}
]
}
- 失败
| status | message |
|---|---|
| 其它 | 有可能出现未知异常，还没有对异常进行全局处理 |
3.离线包下载接口
- 分支节点 :
/mobile/offline/downofflinebagforios.html - 请求方式 :
POST - 请求参数
| key | 类型 | 说明 |
|---|---|---|
| id | String | 要下载的离线包的链接，从上面一个接口获取 |
- 响应结果 :
- 成功
文件传输流
- 失败
| status | message |
|---|---|
| 其它 | 有可能出现未知异常，还没有对异常进行全局处理 |
