概述

基础 API 是基础服务下的传统 HTTP 路由，通过配置匹配规则（路径、方法、Header、Query）与后端绑定，将请求转发到目标后端，并支持超时、URL 重写、重试、请求/响应体积等高级策略。本文介绍如何创建基础 API。

前提条件

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

操作步骤

1. 登录 API 网关专享版控制台，在左侧导航选择目标实例。
2. 进入 API 管理，单击 创建，进入创建基础 API 页面。
3. 按以下模块完成配置。

基本信息

配置项	说明
API 名称	（必填）API 在实例内的标识。
所属服务	（必选）选择已创建的基础服务。

匹配规则

配置项	说明
请求路径	（必填）请求匹配的路径，配合匹配方式使用。
匹配方式	（必选）精确匹配 / 前缀匹配 / 正则匹配。
请求方法	（必选）GET、POST、PUT、DELETE 等 HTTP 方法，支持多选。
Header 匹配	（可选）按请求头的键值与匹配方式（精确/前缀/正则）追加匹配条件。
Query 匹配	（可选）按请求参数的键值与匹配方式追加匹配条件。
优先级	（可选）范围 0-9999，0 为最高优先级，默认为 0。当优先级相同时，按默认路由规则匹配。

默认 API 规则（优先级相同时）：

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

高级配置

超时

启用后，允许请求等待后端响应的最大时间。

配置项	说明
超时时间	单位秒（支持毫秒精度），后端超过该时间未响应时网关返回超时错误。

URL 重写

启用后，转发到后端前重写请求的路径或 Host。

配置项	说明
重写路径	转发到后端时使用的新路径。
重写 Host	转发到后端时使用的新 Host。

重试

启用后，支持配置对失败的请求进行重试的场景。

配置项	说明
重试条件	触发重试的错误场景（如连接失败、后端不可用等），与状态码至少填写一项。
状态码	后端返回指定状态码（如 502、503）时触发重试。
请求重试次数	范围 1-10 次。
单次重试超时	单次重试等待响应的最大时间，单位秒。

后端配置

配置项	说明
后端	（必选）从已创建的后端中选择。
匹配类型/内容	多后端时配置各后端的流量匹配规则，目前支持为不同后端设置流量权重比例

4. 单击 确定 完成创建。

后续操作

• 发布与管理 API：发布 API 使其对外提供服务。
• 插件管理：为 API 绑定限流、认证等插件。