IOS离线包请求API

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
其它 有可能出现未知异常,还没有对异常进行全局处理
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

友情链接更多精彩内容