❗ 接口调用说明

## 接口调用说明 >w ◆ 接口地址:https://api-bmc.kscyin.com/+接口URL; ◆ 当接口返回错误码 `code` **不为零** 表明接口调用出错,此时建议弹窗错误信息 `msg` 字段提示用户; ◆ **请求时 header 中 content-type 必须设置为 ++application/x-www-form-urlencoded++** #### ✔ 接口请求成功一般返回: ```json { "code": 0, //错误码=0 "msg": "ok", "data": "返回的数据内容" //数据类型依据情境可能为 string/array/boolean/object 等 } ``` #### ✖ 接口请求失败一般返回: ```json { "code": 1, //错误码>0,一般=1,有特殊定义的错误码除外,如999 "msg": "数据校验失败" //错误信息,一般会提示失败原因 } ``` >d ⚠ **关于TOKEN** ◆ **没有过期时间**,在同一设备一次登录永久有效; ◆ 通过登录接口生成,获得后存储于本地,**登录成功后建议每个API请求都带上此字段;** ◆ 如:身份校验失败时(帐号在其他设备登录),所有接口将返回 `Code`=999,如下所示: ```json { "code": 999, "msg": "身份校验出错,TOKEN无效!" } ``` >d ⚠ **关于删除操作** ◆ 所有的删除操作在调用API前,要弹出确认弹窗给用户选择,用户操作确认后再调用API。 >i **ℹ 关于分页:** ◆ 所有列表页面的分页都是 **【10条/页】**; ◆ page参数可以不传,默认=1; ◆ 前端列表建议做成无限下拉,判断如果拿到的list条数<10,则显然没有下一页;当一页条数=10时,下拉到底部自动请求page+1,此时若返回 code=1 则表明“没有更多了”。