SuperAPI AI 工具集

rdc-rest-setup

编程与开发

查看项目

更新于 10-16 07:26

技能介绍

用途:为项目配置 @data-client/rest,适用于 rdc-setup 检测出 REST API 模式之后。实施前建议先应用 rdc-rest 技能以获取准确的实现模式。

安装:npm install @data-client/rest;yarn add @data-client/rest;pnpm add @data-client/rest。

主要能力:安装后可根据代码库检测结果,创建一个自定义 RestEndpoint 基类。检测清单包括基础 URL/API 前缀、认证(Authorization 头、localStorage/cookies 中的 token、认证拦截器)、Content-Type、错误处理、请求/响应转换、查询字符串格式。基类通常放在 src/api/BaseEndpoint.ts,通过继承 RestEndpoint 并覆盖方法实现。

常见覆盖点:getHeaders 添加认证头或异步刷新 token;getRequestInit 处理 CSRF 与 credentials;process 解包 { data: ... } 响应外壳;fetchResponse 处理特定状态码(如 401);searchToString 使用 qs 处理嵌套查询参数;parseResponse 处理非 JSON 响应(如 CSV)。

使用方式:基类创建后,用它替代直接使用 RestEndpoint 定义端点,例如 new BaseEndpoint({ path: '/todos/:id', schema: Todo }),或用 resource() 并传入 Endpoint: BaseEndpoint。后续可依次应用 rdc-schema 定义 Entity、rdc-rest 编写资源与端点模式、rdc-react 或 rdc-vue 接入使用。

限制与缺失:资料未提供包版本、价格、性能数据及具体项目适配细节;模板中的 URL、token 获取等代码需按实际项目调整。