接口

大白话解释

接口就是两个程序之间的服务窗口。你去办事大厅递材料，窗口只认固定格式的表格，你按格式填好递进去，里面的人就照单处理，把结果还给你。程序之间也一样，一边按约定把数据递过去，另一边按约定把结果吐出来，双方都不用知道对方内部怎么运转。

它的核心是「约定」：入口地址、能传哪些参数、会返回什么，全部提前说清楚。只要这份约定不变，后台换成什么语言、什么数据库，调用方都不用改。

所以接口既是技术上的边界，也是团队分工的边界。前端和后端、你的应用和外部服务，基本都靠接口对接。

什么时候会遇到

• 前端页面要显示数据，后端说先定接口，于是你们对着字段名一个个对。
• 接第三方服务，比如支付、短信、地图，对方甩给你一份接口文档。
• 自己写的功能要被别的模块调用，得先把输入输出约定清楚再动手。
• 线上排查时看到报错里写着 404 或 500，说明调用的接口地址或服务出了问题。
• 让 AI 助手写代码前，先告诉它接口长什么样，它生成的前后端才能对得上。

可以直接对 Agent 说

「我要做一个获取用户订单列表的接口，入参是 userId 和分页 page，返回订单数组和总数，先帮我写后端路由和类型定义」

「这是后端的接口文档，请按它写前端调用代码，字段名不要自己改，把请求失败时的错误提示也加上」

「帮我检查这两个文件里接口的字段名是否一致，不一致的地方列出来并修正」