什么是基础服务

基础服务用于承载通用 API 代理场景，是基础 API 的归属单元。一个基础服务下可同时关联 HTTP 与 WebSocket 两种请求协议的基础 API，请求路径、方法、请求协议等路由规则在创建基础 API 时配置。

客户端通过基础服务绑定的自定义域名（或实例访问地址）访问服务下的 API，网关根据 API 的匹配规则将请求转发至对应的后端。

适用场景

• 企业存量 HTTP 接口统一接入：按业务域划分基础服务，将各后端服务通过域名后端或固定 IP 后端接入网关，统一收口认证、限流与观测能力。
• 实时双向通信接口代理：消息推送、在线聊天、IoT 上下行等场景，通过 WebSocket 协议的基础 API 代理长连接流量。
• 多后端灰度与容灾：基础 API 支持多服务实例按权重分流，可用于版本灰度与流量切换。

能力一览

前提条件

• 已创建网关实例，且实例处于「运行中」状态，详见创建实例。
• 如需绑定自定义域名，请先在域名管理中创建域名。

使用流程

1. 创建基础服务
2. 在后端管理中创建域名或固定 IP 后端
3. 创建基础 API并发布
4. 按需在管理基础服务中绑定自定义域名、开启消费者认证
5. 通过基础服务监控观察调用情况

相关文档

• 创建基础服务
• 管理基础服务
• 基础服务监控
• 服务概述：三类服务的能力对比。