接口文档案例

接口文档就是后端写给前端,方便前端开发的一个文档。

案例

xxxx接口

xxxx功能

请求url:

POST localhost:8080/xxxx/xxxx/list

请求头:

token: xxxxxxx

请求参数

|------|---------|-----|-----|
| 字段名 | 类型 | 必填 | 描述 |
| page | Integer | 是 | 页数 |
| size | Integer | 是 | 大小 |
| ... | ... | ... | ... |

示例请求体

{
    "page":5,
    "size":10,
    "xxxxx":"111",
    "xxxx":"111",
    "xxx":"111",
    "xxxxxx":"111"
}

返回数据结构

|------|---------|-----|------|
| 字段名 | 类型 | 必填 | 描述 |
| time | String | 否 | 时间 |
| id | Integer | 否 | 主键ID |
| ... | ... | ... | ... |

{
	"data": {
		"list": [
			{
				"time": "2019-01-01",
				"id": 52,
				"name": "张三"
			}
		],
	},
	"code": 0,
	"msg": "成功"
}
相关推荐
江挽枫_Jangmiko15 分钟前
JAVA课堂笔记24(反射+设计模式)
java·开发语言·笔记·设计模式
不修×蝙蝠1 小时前
搭建Tomcat(六)---Response的实现
java·服务器·tomcat·response
真想骂*1 小时前
详解C++中“virtual”的概念及其含义
java·jvm·c++
Sunyanhui12 小时前
牛客网 SQL5将查询后的列重新命名
java·开发语言
白宇横流学长2 小时前
面向特定群体的健康管理平台设计与实现[源码+文档]
java
SUN_Gyq2 小时前
C++如何实现对象的克隆?如何实现单例模式?
java·开发语言·jvm·c++·算法
Beekeeper&&P...2 小时前
AddressBookController
java·前端·网络
Cooloooo2 小时前
最大堆【东北大学oj数据结构9-2】C++
java·数据结构·c++
小黄银技术栈2 小时前
校园点餐订餐外卖跑腿Java源码
java·开发语言
Iam傅红雪3 小时前
修改springboot的配置文件
java·spring boot·spring