aptx-api-core

Installation
SKILL.md

aptx-api-core

在需要接入或调整请求内核时,按以下顺序执行:

  1. 创建 RequestClient,先确定全局配置:baseURLheaderstimeoutquerySerializerdefaultResponseTypestrictDecode。详见 实例化配置
  2. 只在 @aptx/api-core 层处理通用行为,不引入业务认证、缓存、重试逻辑。业务逻辑应通过 MiddlewarePlugin 实现。
  3. 若需求是“按路径前缀/命名空间选择网关或 baseURL”,优先使用 UrlResolver 组合链,不要依赖 middleware 在 URL 固化后再改写。详见 Plugin - 核心组件替换
  4. 通过 use(middleware)apply(plugin) 扩展能力,确保核心逻辑保持纯净。详见 扩展能力
  5. 使用 request:start/end/error/abort 事件做观测,不在事件回调里修改 payload。详见 事件系统
  6. 发生错误时按错误类型分流:HttpErrorNetworkErrorTimeoutErrorCanceledErrorConfigErrorSerializeErrorDecodeError。详见 defaults.md - ErrorMapper

最小接入模板:

import { RequestClient } from "@aptx/api-core";

const client = new RequestClient({
  baseURL: "/api",
  timeout: 10_000,
Related skills

More from haibaraaiaptx/aptx-skill

Installs
23
First Seen
Feb 14, 2026