美文网首页学习藏兵谷Web
接口文档编写示例

接口文档编写示例

作者: elef | 来源:发表于2018-08-27 17:11 被阅读216次

API接口文档的编写已不是什么新鲜事,但文档的编写有时还需针对看文档的人,有所侧重。大多数时候我编写API文档都是针对前台开发、或是后台开发,简单明了就好。比如这两种:
1、wiz笔记中示例


image.png

2、showdoc中的示例


image.png

记得有次公司商务说让我给写几个接口的文档,他给我几点要求:

  1. 有几个接口,分别是什么?(例如XX信息下发接口、XX信息更新接口、XX信息反馈接口)
  2. 每个接口的作用是什么,传递了哪些信息?(例如XX信息反馈接口传递的具体信息内容主要包括:信息 ID 号、信息接收时间、信息展示时间、信息发布情况…….。)
  3. 参考以下格式,每个接口按此编写


    image.png

    照葫芦画瓢,我编写的如下


    image.png

对比上面两种不同的类型,一个关注技术参数,一个关注业务示意。看来很多时候文档还是需要根据受众而变。

相关文章

  • 接口文档编写示例

    API接口文档的编写已不是什么新鲜事,但文档的编写有时还需针对看文档的人,有所侧重。大多数时候我编写API文档都是...

  • 接口文档的编写

    参考资料 如何优雅的格式化接口 如何优雅的“编写”api接口文档 接口文档的编写

  • 新版本四报告

    新版本四报告接口文档,接口代码,数据库定义文档已经完成。 生活习惯报告 接口代码示例: 数据库文档示例 docto...

  • 调数据主要流程

    主要流程 1.查看接口文档: 2.根据接口文档的参数编写services 3.根据接口文档返回的数据编写model...

  • Django项目使用Swagger自动生成API文档

    简介 接口开发完成了,那么接下来需要编写接口文档。传统的接口文档编写都是使用word或者其他一些接口文档管理平台,...

  • 一键生成 API 文档的妙招

    一般接口文档编写完成后,就要开始编写调用接口的代码,很多开发团队都采用传统的通过接口文档的方式来编写接口。但在接口...

  • 接口文档编写

    一.什么是接口 API(Application Programming Interface)即应用程序接口,可以任...

  • markdown写后台api文档

    接口文档示例 用户模块 接口详情 登录接口 接口地址:/user返回格式:Json请求方式:Post请求示例:/u...

  • Vue应用框架整合与实战--前后端分离后的开发模式篇

    开发流程 后台编写和维护接口文档,在 API 变化时更新接口文档 后台根据接口文档进行接口开发 前端根据接口文档进...

  • 在线生成接口文档

    接口文档是项目开发中必需的说明文档,接口文档编写有很多不同的方式,今天本文简单介绍一下常用的几种接口文档编写方法。...

网友评论

本文标题:接口文档编写示例

本文链接:https://www.haomeiwen.com/subject/zajtwftx.html