shebao-server/docs/proto/md/000社保系统交互协议.md

##000社保系统交互协议

APP的版本控制

版本控制采用独立的接口，打开APP应用时调用此接口是否有新版本、是否强制升级。

请求端

域名使用

1. http://app.wodeshebao.com   
    主要服务sbl、pay开头的地址。
    
2. http://www.wodeshebao.com   
    主要服务官网、静态资源、sbw开头的地址(图片上传和访问、App打开接口)
    

接口版本

初步选择接口的版本号跟在URI后面。例：http://localhost/test/v1
URI中的v1标志此接口的版本

HTTP请求头的User-Agent

手机操作系统类型和版本号、本APP的版本号加入到HTTP请求头的User-Agent字段。
格式用"#"符号将系统平台和APP版本号间隔开,平台信息在前、APP版本在后在。

响应

• 响应为JSON格式数据(见下面代码块)。
• code: 响应代码，200为成功，其它值为异常代码。
• msg: 请求执行消息，成功时为空，异常时带有异常信息。
• data: 返回真正的响应数据JSON格式(值是对象，首选是String文本，然后才是对象)

{
    "code": 200,
    "msg": "",
    "data": {
        "name": "中国",
        "age": 9,
        "birthday": "2015-08-13 10:28:55"
    }
}