如何写好API接口文档?
文档注释以斜线后紧跟两个星号（/**）开始，以星号后紧跟一个斜线（*/）作为结尾，中间部分全部都是文档注释，会被提取到API文档中。
URL url表示了接口的请求路径。路径中可以包含参数，称为地址参数，如**/user/{id}**，其中id作为一个参数。
使用 apiblueprint 编写好文档使用，可以使用开源社区提供的一个工具 aglio 来把接口文档渲染成 html 文件， aglio 还会启动一个静态服务器，这样就可以在浏览器里面查看渲染好的文档了。
拼写要准确 接口函数一旦发布就不能改了，要保持兼容性，拼写错误也不能改了，所以要仔细检查拼写，否则会被同行嘲笑很多年。著名悲剧：unix 的 creat 不仅是英文单词不要拼错，时态也不要错。
诸如这样的，就是一些base condition文档字段的一些细节。比如接口中需要传过去多少个字段，每个字段的类型，字段的取值范围，字段的含义，字段传输示例。
Restful接口文档规范
需要有一些api突破restful规范原则。特别是移动互联网的api设计，更需要有一些特定的api来优化数据请求的交互。
restful api接口规范如下：协议 API与用户的通信协议，总是使用HTTPs协议。域名 应该尽量将API部署在专用域名之下。如果确定API很简单，不会有进一步扩展，可以考虑放在主域名下。
同一个 RESTful 接口的多次访问，得到的资源状态是相同的。对该RESTful接口访问，不会使服务端资源的状态发生改变。
RESTFUL特点包括：每一个URI代表1种资源。客户端使用GET、POST、PUT、DELETE4个表示操作方式的动词对服务端资源进行操作：GET用来获取资源，POST用来新建资源（也可以用于更新资源），PUT用来更新资源，DELETE用来删除资源。
按照RESTful的规范，不同的版本也应该用相同的API URL，通过header信息来判断版本，再调用不同版本的程序进行处理。但是这明显会给开发带来巨大的成本。
前端文档接口怎么写
URL url表示了接口的请求路径。路径中可以包含参数，称为地址参数，如**/user/{id}**，其中id作为一个参数。
先理清业务流程 定义前后端开发的接口规范。
首先要有一个文档的标题，XXX接口文档，符合当前文档的说明，文档的生产日期，以及公司名称等。现在开始写一个dubbo接口文档，定义标题，以及日期，这里公司省略。使用confluence在线编辑，Confluence为团队提供一个协作环境。
之后大家都根据这个接口文档进行开发，到项目结束前都要一直维护。
前端如何将后台的数据根据接口展现出来,如图所示,后台使用的JAVA...
这种表格的形式，你可以使用datatables控件，可以通过json的格式传输特定的对象。
可以根据协议写一个JavaBean，将数据封装好之后传到前台页面即可。
使用自定义标签，当使用该标签时会传入一个参数。我们称之为字典Id。该标签会调用后台公共的获取字典map的方法。该接口会根据传的Id到字典表中获取该Id对应的字典。比如上面的“苹果”，“香蕉”，“西瓜”。
之前已经探讨了如何快速创建springboot的项目，可以参考下面的地址，主要是修改pom.xml文件，之前引用了spring-boot-starter，这里因为是要创建restFul接口，所以需要引用spring-boot-starter-web。
order by）。最后，回到jsp页面，根据之前的控制层页面输出，我们需要编写一个role.jsp文件，该文件主要遍历查询数据，使用c标记遍历表单。最后，使用前端页面框架，您可以显示如下所示的前端样式显示。
通过表单传递 前端使用表单时，为name属性赋值，后台controller层方法的参数只要与name的值相同，即可获取到该属性的值。ajax js中将值取出来，通过data这个key传值，数据的值里面也是以key、value的方式，即JSON格式。
一份规范的接口文档应该包括什么内容
1、首先要有一个文档的标题，XXX接口文档，符合当前文档的说明，文档的生产日期，以及公司名称等。现在开始写一个dubbo接口文档，定义标题，以及日期，这里公司省略。使用confluence在线编辑，Confluence为团队提供一个协作环境。
2、接口文档一般是提供给商户对接时进行参考及提供帮助的一个说明文档或API。
3、规范的事情当然要有专业的工具。推荐使用的是docway 写接口文档，方便保存和共享，支持导出PDF MARKDOWN，支持团队项目管理。
如何快速了解一个页面调用的后端接口及接口数据结构
请求后 console.log 打印一下返回的数据。
一般前端跟后端对接是由后端做接口，类似一个链接，前端通过ajax调用接口，然后根据调用接口，获得的数据，赋值。
如果是在教务系统上面，用户操作查询学生的时候，调用“查询学生列表”接口，那么这个接口就是内部接口。如果是在校生管理系统，定期查询“华南可爱小学”教务系统，调用“查询学生列表”的接口，那么这个接口就是外部接口。
那此时，我们把y=x+2称为接口，x=2称为参数，y=4称为返回结果，那这个接口的功能就是能把我们输入的数加上2（注意：这里你可以发现接口自身是带有逻辑的）。