myProject/application/apidoc/logic/header.md

---

介绍

• 介绍

---

#

请求规则

• 测试根地址http://wxapp.dahengdian.com/mobile/
• 生产根地址 ?????
• 根地址请移动端配置好，方便后期发展其他版本
• 接口完成地址拼接方法，http://wxapp.dahengdian.com/mobile/ + cang/getCangList，既为http://wxapp.dahengdian.com/mobile/cang/getCangList，其中http://wxapp.dahengdian.com/mobile/为根地址，cang/getCangList为接口标志
• post请求，json数据

#

请求参数

公共参数

字段	类型	描述
token	String	登录凭证，32位MD5加密字符串，保质期7 * 86400（七天）
time	String	请求时间，格式为2017-01-01 12:12:13
appV	String	APP版本
apiV	String	API版本
osV	String	操作系统版本
osType	Number	1为ios，2为android，3为pc
ip	String	ipv4
channel	String	渠道标志符
deviceID	String	宿主app的唯一标识，长度不限
sign	String	32位MD5加密字符串

###

应用参数

字段	类型	描述
app	String	应用数据

{
    "token": "3e9183e7caa30617c833f06ca86d4134", 
    "time": "2017-12-20 12:52:12", 
    "appV": "1.0.2",
    "apiV": "1.0.2",
    "osV": "Android 6.02",
    "osType": 2,
    "ip": "192.168.0.1",
    "deviceID": "ioajdjfalkslkdiapaa65a4ds54fa5sd1f",
    "channel": "asdfasdfasdf",
    "sign": "9ca2d3bf6ce8936c1e8ecab9ae40c6bf",
    "app": {
      "status": 1
    }
}

#

返回参数

公共参数

字段	类型	描述
time	String	请求时间，格式为2017-01-01 12:12:13
sign	String	签名，32位MD5加密字符串

###

应用参数

字段	类型	描述
app	String	应用数据json格式化字符串，app为json对象，包含code，msg，content三个字段，其中code为错误标识，1为操作成功，负数代表错误；msg错误说明；content为业务数据

{
    "app": {
        "code": 1,
        "msg": "操作成功",
        "content": {
            "cangID": "6"
        }
    },
    "time": "2017-12-20 12:52:12",
    "sign": "4297f44b13955235245b2497399d7a93"
}

#

sign签名规则

• 请求sign = md5(key + token + time + appV +apiV + osV + osType + deviceID + ip + channel + app)，其中登录前状态所有与服务器交互，token为空字符串
• 返回sign = md5(key + time + app)
• sign 签名为小写

Android 推送/H5跳转协议

• bj://h5url?url=https://www.baidu.com/ 打开新的h5页面
• bj://home?url=https://www.baidu.com/ 打开首页
• bj://detail?url=https://www.baidu.com/ 打开产品详情
• bj://huodong?url=https://www.baidu.com/ 打开活动页（显示第三个tab）