V2 0/message/get system list

来自技术开发小组内部wiki
跳转至: 导航搜索

功能说明

获取系统消息列表

URL

http://[域名]/v2_0/message/get_system_list

返回格式

支持json,xml.通过format参数来控制

HTTP请求方式

POST.可以post的数据为xml或json.

输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738
(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明。
(2)私有参数
参数名称 是否必须 类型 描述
uid 可选 int 用户UID
idfa
必须 string
设备号
version
必选 string 版本
opversion
必选 string 操作系统版本
cityid 必选 int 城市分站id

请求示例

正式环境
http://api.fumubang.com/v2_0/message/get_system_list
测试环境
http://api.fumubang.net/v2_0/message/get_system_list
本地环境
http://dev-api.fumubang.net/v2_0/message/get_system_list

返回参数说明

参数 说明
msg_time
消息时间
msg_text
消息内容
ext_field
消息扩展
notification_type
跳转类型 15
android_apk
增加android的apk升级设置
update_version_info
客户端更新版本提示内容

正确返回示例

{
    "msg_list": [
        {
            "msg_time": "2016-11-08 16:10:09",
            "msg_text": "系统消息内容啊",
            "ext_field": {
                "notification_type": 15
            }
        }
    ],
    "android_apk": {
        "apk_channel": "360",
        "version": "3.40",
        "apk_url": "http://img3.fumubang.net/app/android20160729176374.apk",
        "apk_md5": "8f346eb9b267a7b249813eb1a96a5eef",
        "apk_size": "10718632",
        "update_normal_desc": "测试非强制更新内容",
        "update_force_desc": "测试强制更新内容"
    },
    "update_version_info": {
        "update_version": "2.10#2.20#2.30#2.40#2.50#3.02#3.30",
        "update_normal_desc": "非强制更新提示内容22",
        "update_force_desc": "强制更新提示内容11"
    }
}

错误返回示例

{
    "error_code": "300001",
    "error_msg": "参数错误"
}