接口
常规
---
1. APP接口域名:https://app.example.org/api/
2. APP访问路径:https://app.example.org/app/
3. 管理后台接口域名:https://app.example.org/api/admin/
4. 管理后台访问域名:http://admin.example.org
数据返回
---
接口数据返回统一在类中引入 响应Trait: app\Http\Tool\Response.php
* 正常结果返回: sendData($data = null, $msg = '操作成功')
* 正常列表结果返回: sendListData($paginate = [], $msg = '操作成功', $code = 0)
* 操作失败返回: sendErrorData($msg = '操作失败', $code = 1001)
1. 所有的操作失败请注明失败原因;如sendErrorData($msg = '用户名或密码错误!');
2. 所有的正确返回code必须为0;
3. URI中不允许出现下划线,不用大写;
如 https://app.example.org/api/get_banners 或 https://app.example.org/api/Banners
应采用: https://app.example.org/api/banners
4. URI中的名词表示资源集合,使用复数形式。如banners
5. 通常:get获取数据,post提交数据
6. 未登录返回401状态码;无权限返回403状态码;