Z
ZeniCore
/文档中心
文档API 开发

API 开发

2026-04-21 v1.0.0

API 开发

请求封装

基于 Axios 封装,统一请求配置和拦截器,自动处理 Bearer Token 认证。

const api = useApi()

// GET 请求
const data = await api.get('/users')

// POST 请求
const result = await api.post('/users', { name: '张三' })

// PUT 请求
await api.put('/users/1', { name: '李四' })

// DELETE 请求
await api.delete('/users/1')

错误处理策略

  • 401:自动触发登录跳转
  • 403:显示无权限提示
  • 404:引导至 404 页面
  • 500:显示服务器异常提示
  • 网络错误:提供重试选项

接口规范

  • 所有 handler 必须做输入校验
  • 对外错误返回统一结构 { data, error }
  • 禁止把内部堆栈直接返回给客户端
  • 完善的 TypeScript 类型支持