`

接口文档编写

    博客分类:
  • java
 
阅读更多



 

 这个星期在编写接口的过程中遇到了很多问题,也应该总结总结了

1.文档的编写:对需要调用接口的人来说,最重要有3个部分,接口地址,传入参数,返回结果。调用者不会关心内部实现细节,同时后台操作人员也要能够通过阅读文档,获取需要的信息

    所以要把前台需要的3个关键部分放在一起,修改的表以及字段放在最后

 

2.一个需求,接口返回给前台,只有成功和失败2种结果,那么什么情况是成功,什么情况是失败,这个要提前沟通好,然后再写代码

 

3.接口对后台来说同样重要,对后台数据库的一些操作,要明确需要修改什么字段

 

4.一些方法可以进行封装,增强可读性

  • 大小: 65.1 KB
分享到:
评论

相关推荐

    Posix标准接口文档(英文版).pdf

    "Posix标准接口文档(英文版).pdf" 是一份未批准的标准草案,发布日期为2007年6月15日,属于IEEE P1003.1 Draft 3。这份文档详细规定了信息科技领域的可移植操作系统接口,即POSIX®标准的组成部分。此文档的版权由...

    使用apiDoc实现python接口文档编写

    使用 apiDoc 实现 Python 接口文档编写 apiDoc 是一个基于 Node.js 的接口文档生成工具,支持多种编程语言,包括 Python。在本文中,我们将介绍如何使用 apiDoc 实现 Python 接口文档编写。 安装 apiDoc 要安装 ...

    API接口模板-含Word和excel

    在IT行业中,API(应用...根据项目团队的习惯和偏好,可以选择合适的模板来编写API接口文档,以提高开发效率和协作质量。记得定期更新和维护接口文档,保持其与实际API的一致性,这对于API的可持续管理和维护至关重要。

    torna接口文档解决方案 v1.26.0.zip

    Torna是一款开源的项目,它的出现解决了传统接口文档编写繁琐、更新不及时的问题,使得开发流程更加顺畅。 在软件开发中,接口文档扮演着至关重要的角色。它清晰地描述了不同系统或模块之间的交互方式,包括请求...

    服务器接口文档,规范,完整,事例

    通过对提供的接口文档内容进行深入解析,以上知识点涵盖了接口文档编写的核心要素,并提供了在实际开发工作中应用这些知识点的具体方法。正确理解和掌握这些知识点,将有助于提高接口设计的质量和开发效率。

    上海大华电子秤接口文档DEMO等

    在实际应用中,开发者需要根据接口文档编写相应的驱动程序或中间件,以便于系统与电子秤交换数据,如实时获取重量信息、更新PLU库存、实现自动计价等功能。同时,理解并遵循大华电子秤的错误处理机制,可以确保系统...

    sa-doc:一个基于markdown的接口文档编写工具

    一个基于markdown的接口文档编写工具 基础框架基于: 书写格式参考: 根据markdown格式编写api接口文档,写时方便 自动将markdown格式转换为表格形式,看时方便 获取最新代码 你可以从gitee,或者github上获取最新...

    接口相关文档写作规范

    这是一个关于接口设计、开发的文档,一个接口写作规范的文档,希望可以帮到你!

    后端接口文档例子 word

    在本文档中,我们将详细介绍后端接口文档的编写,特别是Java接口文档的编写。通过本文档,我们将了解后端接口文档的重要性、编写格式、请求参数、返回参数等方面的知识点。 一、为什么需要后端接口文档? 后端接口...

    markdown编写api接口文档

    ### markdown编写API接口文档知识点详解 #### 一、Markdown与API接口文档概述 - **Markdown简介**:Markdown是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,尤其适用于编写技术文档、博客...

    银联商务接口文档+gmc+posinf+posinf_outer.rar

    在开发过程中,开发者需要根据银联商务的接口文档编写代码,进行接口测试,确保接口功能正常并符合业务需求。同时,由于涉及到金融交易,安全性和稳定性是重中之重,因此在编码时要遵循最佳实践,进行严格的异常处理...

    showdoc接口文档平台客户端

    Showdoc是一款优秀的接口文档管理工具,它为开发者提供了一个便捷的接口文档编写、管理和分享平台。客户端版本使得用户能够在本地更加方便地使用Showdoc的功能,提高团队协作效率,尤其是在进行API文档整理和项目...

    集成平台接口文档_V1.72.docx

    无论是对于正在学习接口文档编写的新手还是已经熟悉接口设计的专业人士,这份文档都能提供宝贵的参考价值。特别是针对医疗领域的开发人员来说,了解HL7V3标准及其应用场景尤为重要。此外,文档还提供了具体的测试...

    restful接口文档模板

    对于服务端开发者而言,这是一个非常实用的参考指南,可以帮助他们更规范地编写接口文档,提高开发效率和接口的可用性。此外,通过样例演示,读者可以直观地了解如何构建一个完整的RESTful接口,并能根据实际需求...

    API接口文档模版.zip

    API接口文档是软件开发中必不可少的一部分,它定义了服务提供者和消费者之间的交互方式,确保双方能够顺畅地进行数据交换。这份"API接口文档模版.zip"包含了两种格式的文档:一个Markdown(.md)文件和一个PDF文件,...

    接口文档模板.docx

    综上,接口文档的编写不仅涉及接口的定义,还包括测试、安全、文档规范等多个方面,它是保障系统间通信顺畅的关键。通过模板化的文档整理,可以帮助开发者更高效地理解和使用接口,降低沟通成本,提高开发质量。

    支付宝接口文档和源码

    2. **实现接口调用**:根据接口文档编写代码,发起支付请求,处理回调结果。 3. **用户界面集成**:设计用户友好的支付页面,引导用户完成支付过程。 4. **错误处理和日志记录**:建立完善的异常处理机制,记录交易...

    第一节 编写接口文档第一节 编写接口文档第一节 编写接口文档

    第一节 编写接口文档第一节 编写接口文档第一节 编写接口文档

Global site tag (gtag.js) - Google Analytics