OpenAPI
目前描述REST API最广泛使用的标准规范（前身为Swagger），以JSON或YAML格式定义接口路径、请求参数、响应结构及认证方式，是业界事实标准
核心事实
时间轴 (近 90 天)
SiteCheck 同时提供 OpenAPI 和远程 MCP 服务器两种接入方式，MCP 端点地址为 https://api.sitecheck-api.workers.dev/mcp。
Hoppy 是一个命令行工具，能够将现有的 OpenAPI 契约直接转换为 MCP 服务器，无需编写服务器代码。
在智能体语境下，结构化访问指的是软件以机器可读、语义明确的方式暴露其功能与数据，通常是 REST/GraphQL API、MCP工具定义、或 OpenAPI 规范描述的可调用动作。
OpenAPI 规范描述结构，但“同一端点、新位置”的语义存在于人类意图中，不在 JSON 里；任何确定性 differ 都是在猜测意图。
原始 OpenAPI diff 实现通过直接对路径字符串做哈希来检测重命名，导致 /v1/users/{id} 重命名为 /v2/accounts/{id} 时被报告为删除加新增两个独立变更，而非一次重命名。
跨语言服务拆分带来契约一致性成本：三层中任何一层字段名拼错、类型不一致或缺默认值都会导致静默失败，实践中常用OpenAPI/Swagger固化契约。
MCP 服务器生成工具时将 OpenAPI 规范中每个 operationId 对应的操作翻译成可供模型调用的函数，函数名、入参类型和描述都来自规范本身
在.NET中给request model加上attribute，字段信息会自动进入OpenAPI spec
AI Agent主要依赖OpenAPI spec和字段描述来理解接口，而人类开发者会阅读文档并对模糊字段进行推测
审查者应验证AI生成代码的请求负载、响应模型和可空性规则是否严格匹配权威来源，如OpenAPI规范、Protobuf定义或数据库schema
还有 26 条时间轴事件
全部知识事实 (20)
FastAPI基于Starlette和Pydantic构建，天然支持异步处理，基于ASGI（Asynchronous Server Gateway Interface）
80%已验证OpenAI 的 Function Calling 和 Anthropic 的 Tool Use API 都是 ReAct 模式的标准化实现
80%已验证OpenAPI/Swagger规范驱动的API开发是规格驱动开发理念的成功实践，先定义接口规格再自动生成服务端框架和客户端SDK
75%已验证Swagger已更名为OpenAPI Specification，是一套用于描述RESTful API的标准化规范，以JSON或YAML格式定义API信息，目前业界广泛使用OpenAPI 3.0/3.1版本
70%已验证FastAPI自动生成符合OpenAPI 3.0规范的JSON描述文件，支持Swagger UI和ReDoc两种文档风格
65%待验证该学习路线定义了基于Swagger/API文档的五类接口测试用例自动生成策略：正向、反向、错误、模糊需求和数据编码场景
85%待验证多Agent系统中前后端Agent间的状态同步与接口契约是核心工程挑战，业界通常通过共享Schema定义或中间协调层来解决
80%待验证早期ChatGPT插件采用OpenAPI规范描述接口，通过函数调用（Function Calling）机制与第三方API交互
70%待验证LibreChat支持OpenAPI规范的Actions和Functions调用，用户通过定义OpenAPI schema即可扩展AI能力
60%待验证业界通常用API-First开发方法论（如OpenAPI/Swagger定义接口契约）来解决前后端接口对齐问题
60%待验证SiteCheck 同时提供 OpenAPI 和远程 MCP 服务器两种接入方式，MCP 端点地址为 https://api.sitecheck-api.workers.dev/mcp。
50%待验证Hoppy 是一个命令行工具，能够将现有的 OpenAPI 契约直接转换为 MCP 服务器，无需编写服务器代码。
50%待验证在智能体语境下，结构化访问指的是软件以机器可读、语义明确的方式暴露其功能与数据，通常是 REST/GraphQL API、MCP工具定义、或 OpenAPI 规范描述的可调用动作。
50%待验证OpenAPI 规范描述结构，但“同一端点、新位置”的语义存在于人类意图中，不在 JSON 里；任何确定性 differ 都是在猜测意图。
50%待验证原始 OpenAPI diff 实现通过直接对路径字符串做哈希来检测重命名，导致 /v1/users/{id} 重命名为 /v2/accounts/{id} 时被报告为删除加新增两个独立变更，而非一次重命名。
50%待验证跨语言服务拆分带来契约一致性成本：三层中任何一层字段名拼错、类型不一致或缺默认值都会导致静默失败，实践中常用OpenAPI/Swagger固化契约。
50%待验证MCP 服务器生成工具时将 OpenAPI 规范中每个 operationId 对应的操作翻译成可供模型调用的函数，函数名、入参类型和描述都来自规范本身
50%待验证AI Agent主要依赖OpenAPI spec和字段描述来理解接口，而人类开发者会阅读文档并对模糊字段进行推测
50%待验证在.NET中给request model加上attribute，字段信息会自动进入OpenAPI spec
50%待验证审查者应验证AI生成代码的请求负载、响应模型和可空性规则是否严格匹配权威来源，如OpenAPI规范、Protobuf定义或数据库schema
50%