很多人会谈论接口或者 API 的定义，但到底什么是接口定义？又该如何阅读？今天咱们就把这事儿彻底捋清楚。
一、前端和后端
在聊接口之前，得先明确两个基本概念：前端和后端。
前端就是我们眼睛直接看到的网页或 App 页面，它由 HTML 和 CSS 搭建，负责展示漂亮的界面，顺便做点简单的校验——比如确保必填字段不能为空。后端则藏在服务器里，负责真正的业务逻辑和功能实现，比如购物结算、发布微博。当你在页面上点“购买”或“发送”时，前端把指令传过去，后端就默默地扣钱、发帖。那么问题来了：前后端之间怎么通信？靠的就是接口。
听起来有点抽象？简单记：前端管界面好不好看，后端管功能能不能跑。无论是网页、安卓/iOS 客户端、微信小程序，还是 Windows/Mac 上的软件，道理都一样——你的手机或电脑上运行的是前端，服务器上跑的是后端。在公司里，前端和后端通常由不同岗位的工程师负责，开发的内容也完全不同。
二、接口
搞清了前后端的区别，接口就好理解了。
接口是一种通信机制，让前端和后端能交换信息。你可以把它想象成两个人对话：前端是提问的人，后端是回答的人。当前端需要数据或执行某个任务时，它会通过接口向后端发一个“请求”——就像问一个问题，告诉后端“我需要什么”。后端收到后，根据请求执行操作，然后把结果“响应”回来——就像给出答案。一来一回，应用的功能就运转起来了。
举个最直接的例子：你在购物网站上点“加入购物车”，前端就会向后端发一个请求，说“把这件商品加到购物车”。后端执行完操作，返回一个结果：“添加成功”。这种问答式的交互贯穿了整个应用。接口也叫 API（Application Programming Interface），日常讨论中这两个词可以互换。
三、接口定义
每个服务都会提供不同的接口。比如麦当劳的点餐系统至少要提供这几个接口：
- 查看菜单
- 下单
- 查询我的订单
打开麦当劳小程序，小程序会发起“查看菜单”请求，服务器返回菜单数据，显示在手机上。你选好餐点击“下单”，小程序发起下单请求，服务器返回“下单成功”。你点“我的订单”，同样发起查询请求，服务器返回订单列表。
以“下单”为例，下单请求里必须包含消费者信息以及点了什么餐，否则服务器无法处理。同样，服务器返回的下单成功信息也必须包含这些内容，不然小程序显示不全。也就是说，开发工程师在写代码时，就已经约定好了信息交换的格式：客户端请求必须包含哪些字段，服务端返回必须包含哪些字段。这个约定就是接口定义。
每个服务都包含很多种接口，比如上面三种，各自都有一套请求和返回的规范。所以接口定义的本质，就是软件开发中关于前后端如何交互的结构化规定。前后端遵循同一套定义，才能协作实现复杂功能，同时保证系统的稳定和可靠。
四、接口定义的组成
一个完整的接口定义通常包含以下几个部分：
- 接口名称：用于区分不同接口的标识符。
- 接口方法：包括 GET、POST、PUT、DELETE 等。
- 接口地址：接口的访问路径。
- 请求参数：输入参数，包括参数名称、类型、说明等。
- 响应参数：输出结果，包括返回值类型、名称、说明等。
一个典型的接口定义长这样：
五、阅读主流厂商的 API 定义
对接口定义有了基本了解后，不妨看看主流大厂的 API 定义来加深理解。例如下面的企业微信 API 定义：
