shebao-server/docs/proto/md/APP打开接口.md

APP打开接口

返回首页数据和客服电话、版本信息。

1. Android请求接口得到版本号和 update_url，需要更新app应用时，直接调用接收到的update_url链接下载新版本。
   
   
2. uriList 里的字符，以http开头的话，不用拼接url,直接应用于跳转。

• 2016-09-27 增加update_url字段，用于更新版本。接口增加appname参数，用于区分更新包。
• 2016-05-04 增加转移的城市数据版本字段 move_city
• 2015-12-28 增加城市查询的版本字段(query)
• 2015-12-98 增加uriList字段，不跳转图片对应是空的。

请求

URI

/sbw/open  请求方式：GET

参数

String appname      应用名称，关系到版本更新(我的社保：wdsb  五险一金：wxyj)

需要保证Request的User-Agent属性与系统版本相同，格式：系统#版本(iOS#1)

响应

状态码

200     成功

DATA说明

v    版本
    int version                 iOS版本号 / Android版本号
    String desc                 版本描述
    boolean force = false       是否强制更新
    int force_version = 0       强制更新的版本(小于此版本的强制)、默认0(不要求)
    String update_url           可直接用于应用更新的网路链接
String tel         客服电话
List barList       首页bar图片链接、用www.wodeshebao.com访问
List uriList       首页bar图片的跳转、用www.wodeshebao.com访问
List ads           首页的服务数据列表。
Integer city       城市版本号，小于此版本值需要刷新城市数据(大小比较)
Integer query      城市查询配置的数据版本(大小比较)
Integer move_city  转移的城市数据的版本(大小比较)

uriList说明：
以“/"开头的是H5链接;
key-value格式是APP内模块跳转。下面例子：

• 有参：uriList.add("{\"module_name\":{\"param1\":\"value1\", \"param2\":\"value2\"}}");
• 无参：uriList.add("{\"module_name\":{}}");
• uriList 里的字符，以http开头的话，不用拼接url,直接应用于跳转。

数据范例

{
    "data": {
        "v": {
            "version": 1,
            "desc": "",
            "force": false,
            "force_version": 0,
            "update_url": "http://www.shanp.com/files/{appname}/wodeshebao.apk" // Android更新链接
        },
        "query": 15122810,
        "tel": "400-062-2002",
        "uriList": ["", "/sbw/ent/to"],
        "barList": ["/img/banner001.png", "/img/banner002.jpg"],
        "ads":[{
            "img": "/upload/ad/181112162105.jpg",
            "title": "办信用卡",
            "notes": "有优惠，大额度",
            "link": "http://124.89.54.3/haha/d51.html"
        }],
        "city": 15101510，
        "move_city": 1605001
    },
    "msg": "",
    "code": 200
}