diff --git a/docs/zh/sys-ajax/README.md b/docs/zh/sys-ajax/README.md index 1a04317e..cda14051 100644 --- a/docs/zh/sys-ajax/README.md +++ b/docs/zh/sys-ajax/README.md @@ -36,7 +36,7 @@ Latest ✔ | Latest ✔ | Latest ✔ | Latest ✔ | Latest ✔ | 11 ✔ | axios 默认的使用方式在这里不做介绍,D2Admin 推荐在您的项目中使用下面的方式获取数据: -### 修改 baseURL +### 设置接口地址 默认的请求地址在 `d2-admin/.env` @@ -46,6 +46,8 @@ VUE_APP_API=/api/ 上述设置将在您访问 `/demo/a` 时实际去访问 `/api/demo/a` +### 区分不同环境设置接口地址 + 如果您希望不同的环境使用不同的请求地址,可以在 `d2-admin/.env.development` 中添加设置(示例): ``` @@ -75,7 +77,19 @@ VUE_APP_API=/api-dev/ } ``` -当发生错误(注:这里指的错误不是 http 错误,而是和后台约定好的错误类型)时返回的数据示例: +在响应拦截器中处理完数据后将会返回: + +``` js +{ + list: [ + ... + ] +} +``` + +### 业务错误 + +当发生错误时返回的数据示例: ``` js { @@ -86,7 +100,7 @@ VUE_APP_API=/api-dev/ } ``` -如果针对某个错误(注:这里指的错误不是 http 错误,而是和后台约定好的错误类型)指定处理方法,应该在响应拦截器中加入对应的代码: +如果针对某个错误指定处理方法,应该在响应拦截器中加入对应的代码: ``` js service.interceptors.response.use( @@ -99,11 +113,33 @@ service.interceptors.response.use( ) ``` +### http 错误 + 如果需要针对某个 http 错误指定处理方法,应该在响应拦截器中第二个参数中添加对应的代码。 -::: tip +### 不返回 code + 在默认的设置中,如果您的接口没有返回 code 字段,将不会进行状态(非 http 状态,而是和后台约定好的状态类型)判断,直接返回 axios 请求返回的数据。 -::: + +例如接口返回如下数据: + +``` js +{ + list: [ + ... + ] +} +``` + +在响应拦截器中判断该接口没有返回 code 字段,将会直接将返回: + +``` js +{ + list: [ + ... + ] +} +``` ### 设计 API