跳转到内容

后端与数据 · DEFINED TERM

API

不同程序按照约定交换数据或调用能力的接口。

你可能会这样说“前端通过一个固定入口获取项目列表”

VISUAL EXAMPLE

先看懂它怎么工作

容易误解不要让调用方依赖数据库内部表结构
更准确连接前端、后端、第三方和 Agent 工具

MECHANISM

运行机制

  1. 调用方按约定发请求
  2. 服务验证处理
  3. 返回结构化结果

USE WHEN

适合这样用

连接前端、后端、第三方和 Agent 工具

NOT FOR

不要这样理解

不要让调用方依赖数据库内部表结构

TELL YOUR AGENT

可直接发给 Agent

请按“API”的概念处理这个需求:前端通过一个固定入口获取项目列表。先说明实现边界,再给出可检查的结果。

ACCEPTANCE

怎么确认它真的做好了

输入输出有文档,错误码稳定,权限边界明确

OFFICIAL SOURCES

官方来源