简要描述:

  • 项目开发模板 ------分页模板

请求域名:

  • http://xx.com

请求URL:

POST: plugin.xxxxx

参数:

参数名 是否必须 类型 说明
page number 请求第几页的数据

返回示例:

result : 请求处理状态 1: 请求处理成功 0: 请求处理失败

data: 响应返回的实体数据

data.data: 响应返回的列表数据
data.data没有数据时需要返回空数组 []

列表为空时需要返回空数组 [ ]

对象为空时需要返回空对象 { }

尽量不要返回null

嵌套尽量不要太多

关于数字类型, 没有特殊情况一般需要限制两位小数返回

关于Boolean类型,JSON数据传输中一律使用1/0来标示,1为是/True,0为否/False;

关于日期类型,JSON数据传输中一律使用字符串,具体日期格式因业务而定;

接口返回数据时需要注意数组和对象 [ ] != { }

正确时返回:

{
	"result": 1,
	"msg": "ok",
	"data": {
		"total": 0,
		"per_page": 20,
		"current_page": 1,
		"last_page": 0,
		"data": [
		 	{
		  		"id": 1
		 	}
		]
	}
}

错误时返回:

  {
  "result": 0,
  "msg": "接口出错",
  "data": []
}

返回参数说明:

参数名 类型 说明
total number 总记录数
per_page number 每页大小
current_page number 当前页数
last_page number 最后一页/总页数
data number 数据列表

备注: