什么是基础 API

基础 API 是基础服务下的路由，通过配置匹配规则（路径、方法、Header、Query）与后端绑定，将请求转发到目标后端。基础 API 支持 HTTP 与 WebSocket 两种请求协议，可同时承载常规请求-响应接口与实时双向通信接口。

能力一览

匹配优先级规则

多个 API 同时满足请求时按 优先级 生效，数字越小优先级越高。优先级相同时按以下默认规则匹配：

1. 匹配方式优先级：精确匹配 > 前缀匹配 > 正则匹配；
2. 路径段数匹配多的优先级高，例如 /a/b 优先级大于 /a；
3. Header 匹配数量多的优先级高，Header 优先级大于 Query；
4. Query 匹配数量多的优先级高。

前提条件

• 已创建基础服务，详见基础服务概述。
• 已在后端管理中添加好域名或 IP 后端。

使用流程

1. 创建基础 API：配置匹配规则、后端与高级策略
2. 发布与管理基础 API：发布 API 使其对外提供服务
3. 按需为 API 绑定插件（限流、跨域、请求响应转换等）
4. 通过基础 API 监控观察调用情况

相关文档

• 创建基础 API
• 发布与管理基础 API
• 基础 API 监控
• API 概述：三类 API 的能力对比。