⚠️ 接口调用说明

## 接口调用说明 >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,此时若返回列表为空,则表明“没有更多了”。