⚠️ 接口调用说明
## 接口调用说明
>w ◆ **接口服务器**拼接地址:`https://api.rukhpark.com/+接口URL`;
◆ 当接口返回错误码 `code` **不为零** 表明发生错误,此时建议弹窗错误信息 `msg` 字段提示用户;
◆ **请求时 `header` 中 `content-type` 必须设置为 ++`application/x-www-form-urlencoded`++**
◆ 每个IP地址限制每分钟请求 `45` 次(暂定),超额返回状态码和错误码`429`,并在`Header`中携带`Retry-After` ,值为需等待的秒数。
接口请求成功一般返回:
```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无效!"
}
```
>i **关于H5服务器:**
◆ **测试**时访问域名:`h5.rukhpark.com`
◆ **上线**时访问域名:`m.rukhpark.com`
◆ **发布前务必记得切换域名!**
>d ⚠ **关于删除操作**
◆ 所有的删除操作在调用API前,要弹出确认弹窗给用户选择,用户操作确认后再调用接口。
>i **关于分页:**
◆ 所有列表页面的分页都是 **【10条/页】**;
◆ `page`参数可以不传,默认=1;
◆ 前端列表建议做成无限下拉,判断如果拿到的list条数<10,则显然没有下一页;当一页条数=10时,下拉到底部自动请求page+1,此时若返回列表为空,则表明“没有更多了”。