接口调用说明
## 接口调用说明
>w ◆ **测试服务器**接口拼接地址:https://dev.api.llpt.cygame.cn/+接口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无效!"
}
```
>i **关于资源服务器:**
◆ 每个项目可申请资源服务器,取得++资源目录+FTP++;
◆ **测试**时资源服务器访问域名:assets.games.52nanm.com;
◆ **上线**时资源服务器访问域名:cdn-s2.52nanm.com;
◆ 资源服务器域名需拼接具体路径使用;
◆ **发布前务必记得切换域名!**
>d ⚠ **关于删除操作**
◆ 所有的删除操作在调用API前,要弹出确认弹窗给用户选择,用户操作确认后再调用API。
>i **关于分页:**
◆ 所有列表页面的分页都是 **【10条/页】**;
◆ page参数可以不传,默认=1;
◆ 前端列表建议做成无限下拉,判断如果拿到的list条数<10,则显然没有下一页;当一页条数=10时,下拉到底部自动请求page+1,此时若返回 code=1 则表明“没有更多了”。