❗ 接口调用说明
## 接口调用说明
>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 则表明“没有更多了”。