什么是接口文档,如何写接口,有什么规范

 我来答
ci...w@163.com
推荐于2018-03-13
知道答主
回答量:0
采纳率:0%
帮助的人:0
展开全部
首先要有一个文档的标题,XXX接口文档,符合当前文档的说明,文档的生产日期,以及公司名称等。现在开始写一个dubbo接口文档,定义标题,以及日期,这里公司省略。使用confluence在线编辑,Confluence为团队提供一个协作环境。团队成员协同地编写文档和管理项目。从此打破不同团队、不同部门以及个人之间信息孤岛的僵局,Confluence实现了资源的共享。

接下来要有当前文档的版本修订信息,即为历史修订信息,应当包含基础的信息有:版本号、修订日期、修订人、修订说明等。

开始编写文档的目录结构,注意大标题和小标题的使用,需要合理的运用说明。首先当然是文档的说明信息,再来是一些准备信息和流程信息,然后开始接口说明,最后可以有举例、常见问题、注意事项、响应码的说明信息等等。

下面开始按照文档的目录结构逐一进行详细的介绍说明,比如文档说明的介绍,用高效简洁的语言明确的说明文档信息,注意文档中大标题应当字体大小样式一致,小标题也应当字体大小注意保持一致。

简单的说明技术资料获取及准备,确认调用系统信息比较重要,需要确认编码格式,防止乱码,确认当前的文档版本是否是要使用的版本,否则白做无用功,项目的搭建环境简单说明即可。

开始说明接口的调用流程,如何调用接口,需要做的一些准备,说明引入相应的依赖以及配置需要配置的文件。

现在可以开始接口的说明,接口的说明信息应当包含接口的名称,接口的地址,接口的协议,然后针对当前接口下的方法说明。

方法的说明应当包含方法的描述,即其作用,方法的请求参数说明,以及响应的参数说明,参数说明应当包含参数的类型,参数名称,参数的含义,并且备注参数是否必须传递。

9
接口说明完之后,就是文档的末尾,有注意事项添加一些注意事项,或者附录说明,添加标注。
推荐律师服务: 若未解决您的问题,请您详细描述您的问题,通过百度律临进行免费专业咨询
?>

为你推荐:

下载百度知道APP,抢鲜体验
使用百度知道APP,立即抢鲜体验。你的手机镜头里或许有别人想知道的答案。
扫描二维码下载
×

类别

我们会通过消息、邮箱等方式尽快将举报结果通知您。

说明

0/200

提交
取消

辅 助

模 式