一、概念
后端的接口文档(API文档)——全称为应用程序编程接口(Application Programming Interface)文档,是详细阐述特定软件应用程序或Web服务所开放接口的具体使用指南。这份文档为开发者提供了与这些接口进行交互的详细信息和规则,确保他们能够有效地利用这些接口来集成、扩展或与其他软件系统进行通信。换句话说,API文档里记录了一些方法。这些方法用来指导如何进行某个操作,API里写明这些方法的要求与参数,至于底层如何运行后端来书写。
二、示例一个接口文档
这是登录部分注册功能的API文档。我们会发现文档中声明了某功能的一系列要求,包含作用,请求方式,路径,入参(包括类型和是否必有),出参和数据样本等等