api-http-patterns.mdc 923 B

1234567891011121314151617181920212223242526272829303132333435363738
  1. # API 和 HTTP 请求规范
  2. ## HTTP 请求封装
  3. - 可以使用 `简单http` 进行请求管理
  4. - HTTP 配置在 [src/http/](mdc:src/http/) 目录下
  5. - `简单http` - [src/http/http.ts](mdc:src/http/http.ts)
  6. - 请求拦截器在 [src/http/interceptor.ts](mdc:src/http/interceptor.ts)
  7. - 支持请求重试、缓存、错误处理
  8. ## API 接口规范
  9. - API 接口定义在 [src/api/](mdc:src/api/) 目录下
  10. - 按功能模块组织 API 文件
  11. - 使用 TypeScript 定义请求和响应类型
  12. - 支持 `简单http`请求方式
  13. ## 示例代码结构
  14. ```typescript
  15. // API 接口定义
  16. export interface LoginParams {
  17. username: string
  18. password: string
  19. }
  20. export interface LoginResponse {
  21. token: string
  22. userInfo: UserInfo
  23. }
  24. ```
  25. ## 错误处理
  26. - 统一错误处理在拦截器中配置
  27. - 支持网络错误、业务错误、认证错误等
  28. - 自动处理 token 过期和刷新
  29. ---
  30. globs: src/api/*.ts,src/http/*.ts
  31. ---