aptx-api-core
Installation
SKILL.md
aptx-api-core
在需要接入或调整请求内核时,按以下顺序执行:
- 创建
RequestClient,先确定全局配置:baseURL、headers、timeout、querySerializer、defaultResponseType、strictDecode。详见 实例化配置 - 只在
@aptx/api-core层处理通用行为,不引入业务认证、缓存、重试逻辑。业务逻辑应通过 Middleware 和 Plugin 实现。 - 若需求是“按路径前缀/命名空间选择网关或 baseURL”,优先使用
UrlResolver组合链,不要依赖 middleware 在 URL 固化后再改写。详见 Plugin - 核心组件替换 - 通过
use(middleware)或apply(plugin)扩展能力,确保核心逻辑保持纯净。详见 扩展能力 - 使用
request:start/end/error/abort事件做观测,不在事件回调里修改 payload。详见 事件系统 - 发生错误时按错误类型分流:
HttpError、NetworkError、TimeoutError、CanceledError、ConfigError、SerializeError、DecodeError。详见 defaults.md - ErrorMapper
最小接入模板:
import { RequestClient } from "@aptx/api-core";