接口文档规范有哪些?

接口测试的依据,每每不是需求文档,而是接口文档。api

那么,接口文档的准确性便相当重要,本文推荐apipost接口文档生成工具生成的接口文档,供你们参考。工具

接口文档无论以什么形式存在,须要包含的内容有:post

  1. 接口名称
  2. 接口类型
  3. 输入参数

每一个参数名;测试

每一个参数类型;spa

每一个参数业务含义;3d

每一个是否可空;blog

每一个字段长度(可选,通常须要提供,有严格要求的字段需特别注明);接口

每一个参数的单位(可选,金额类字段需注明);ip

d. 输出结果rem

每一个参数名;

每一个参数类型;

每一个参数业务含义;

每一个是否可空;

每一个参数的单位(可选,金额类字段需注明);

返回状态的取值范围及其业务含义。

在线格式接口文档

word格式接口文档

接口测试接口文档生成工具apipost下载地址:www.apipost.cn

相关文章
相关标签/搜索