JavaScript - 后端接口编写规范示例(API)
2023-09-11 14:15:54 时间
前言
当后端完成一个 API
接口时,通常需要 与前端人员沟通接口的细节,这时候,一个文档就能节省很多效率,大大减少沟通成本,如何撰写一份规范文档呢?
功能描述
用最简洁清晰的语言,让不懂后端的前端一看就懂。
主要说明该方法实现什么功能(很重要),涉及术语需要标注。
URL地址
例如:/admin/user/
请求方式
调用该接口前端需要使用什么方式来请求(GET / POST / PUT / DELETE …)
请求参数
此块最好使用表格来描述。
调用该接口时,前端需要传递哪些参数值,主要有以下几个方面:
- 【字段】:对应的字段名称,如
userName
/pwd
。 - 【说明】:对于该字段的说明,如
用户名
/密码
。 - 【类型】:对于该字段类型,如
Array
/Object
。 - 【是否必填】:
Y/N
/True/False
- 【备注】:对于该接口有什么备注。
相关文章
- JavaScript图形实例:平面镶嵌图案
- 第七节:语法总结(1)(自动属性、out参数、对象初始化器、var和dynamic等) 图片放大镜 JavaScript-基础 用javascript写原生ajax(笔记) 初遇 Asp.net MVC 数据库依赖缓存那些事儿 前端JS 与 后台C# 之间JSON序列化与反序列化(笔记)
- 原生 javascript 基础回顾
- JavaScript - 自动下载接口返回的文件流
- 【JavaScript】关于javascript原型的深入理解
- 【JavaScript】重温Javascript继承机制
- 【JavaScript】理解与使用Javascript中的回调函数
- JavaScript API
- ArcGIS Javascript 图层事件绑定
- 《JavaScript数据可视化编程》——1.6 使用雷达图显示多维数据
- 《JavaScript设计模式》——第9章 JavaScript设计模式9.1 Constructor(构造器)模式
- 《众妙之门——JavaScript与jQuery技术精粹》——1.4 事件代理
- 《JavaScript忍者秘籍》——第1章 进入忍者世界 1.1即将探索的JavaScript库
- 《jQuery与JavaScript入门经典》——2.2 调试HTML元素
- 2015第37周五javascript函数arguments对象巧用一
- 使用 HTML、CSS 和 JavaScript 的实时计算器
- JavaScript 代码简洁之道
- javascript——正則表達式
- 【javascript】如何在Javascript中创造map对象?
- JavaScript模块化思想之CommonJS、AMD、CMD、UMD
- javascript面向对象之Object.defineProperty(a,b,c)