接口文档的编写

接口文档

背景介绍

API(Application Programming Interface)即应用程序接口。可以认为 API 是一个软件组件或是一个 Web 服务与外界进行的交互的接口。

目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力,而又无需访问源码,或理解内部工作机制的细节。

这里接口就是后端写的方法。

比如

**substring()**方法是做裁剪的,里面两个数值(start,end)--裁剪开始,结束。最后返回裁剪好的。

接口文档

双方约定的手册,后端按照规定来,前端调用这个方法知道需要传什么参数。

给一个类似这种文档,后端不需要等待,按照这个规则去写,前端按照这个规则去用。


word书写接口文档

  1. 注明哪一模块,这里以登录模块为例。

  2. 实现的功能,比如 注册功能。(以下均以注册为例)

  3. 作用: 用于用户注册

  4. 请求路径:RegisterServlet

请求方式:post/get 这里是post

传输的数据类型:json

请求的入参:

account(账号) 类型:字符串 必传

password(密码) 类型:字符串 必传

  1. 数据样本:

{

"account":"admin",

"password":"123456"

}

  1. 响应的出参:

code(状态) 类型: 整数 必有 code如果是1表示注册成功,code如果是0表示注册失败。

message(信息) 类型:字符串 必有

  1. 注册成功数据样本:

{

"code":1.

"message":"注册成功"

}

8.注册失败数据样本:

{

"code":0.

"message":"注册失败"

}

相关推荐
Json_1817901448019 小时前
淘系商品评论json数据示例参考,API接口系列
大数据·json·api
北京_宏哥2 天前
python接口自动化(三十五)-封装与调用--流程类接口关联(详解)
前端·python·api
SuperherRo4 天前
基础入门-Web应用&蜜罐系统&堡垒机运维&API内外接口&第三方拓展架构&部署影响
api·堡垒机·蜜罐·第三方应用
RacheV+TNY2642784 天前
低代码/无代码开发平台下的API接口创新实践
大数据·网络·爬虫·python·api
VIP_CQCRE4 天前
AI证件照制作 API 快速生成证件照
api
数据龙傲天5 天前
API接口性能优化:提升电商数据处理速度的关键
爬虫·python·性能优化·数据分析·api
Json_181790144805 天前
电商商品详情API接口(item get)数据分析上货
api
RacheV+TNY2642785 天前
2024年API接口发展趋势:智能化、自动化引领潮流
人工智能·python·自动化·api
lovelin+v175030409667 天前
智能化API:如何重塑企业业务流程与用户体验
大数据·人工智能·爬虫·python·api
数据龙傲天7 天前
电商数据API接口:连接前端与后端的纽带
大数据·爬虫·python·数据分析·api