如何正确规范写接口文档

前言

　　正规的团队合作或者是项目对接，接口文档是非常重要的，一般接口文档都是通过开发人员写的。一个工整的文档显得是非重要。下面我将我看到的一篇接口文档做一个总结

开始吧！！！

接口1： 查询排重接口

具体返回结果举例：

1、查询成功

{
  "state": 10000,
  "message": "success",
  "data": {
    "BD239708-2874-417C-8292-7E335A537FAD": 1 //已经存在
  }
}

{
  "state": 10000,
  "message": "success",
  "data": {
    "BD239708-2874-417C-8292-7E335A537FAD": 0 //不存在
  }
}

1. 接口调用失败

{
  "state": 10010,
  "message": "access prohibited",
  "data": [

  ]
}

原文地址：https://www.cnblogs.com/xiaogou/p/9316050.html