@xsyx/easy-api-h5 NPM

api 使用手册

完整规范请参考 https://www.yuque.com/xsued/book/lz3qo4

初始化

// import EasyApi from '@xsyx/easy-api-h5'; // 这种也可以
import { registerModule } from '@xsyx/easy-api-h5';


export const commonApi = registerModule({
  prefix: 'http://test.xsts.xyz', // 请求的统一前缀
  module:{}, // 请求的接口基本信息，见 「module 配置规范」
  loading: true,//全局的loading
  // 以下皆为可选项
  mock: true, // 是否使用mock，全局有效（可选项）
  timeout: 15* 1000, // 超时时间
  // 标准化返回格式，如果响应格式不符合规范，则通过该函数进行标准化，
  // success 为 false 的返回将会走到 exception 
  standard: (response)=>{ // easeApi 接受的标准是 { data, code, success: true/false, message}; 
    const {rspCode, data, rspDesc} = response
      return {
          code: rspCode,
          success: rspCode === 'success', // code === '200'
          data: data,
          message: rspDesc
      }
  }, 
  headers: {// 全局头部（可选项）
  	Authorization: async function(){// 可为函数
			return await kylinApi.getToken();
		}
  }, 
  hooks:{ // 全局钩子（可选项）
    afterFetch:[
    	(url, response, params, options)=>{
      	console.log(response)
      }
    ],
    beforeFetch:[
    	(url, response, params, options)=>{
      	console.log(response)
      }
    ]
  },
  plugins:{ // 注册吐司消息插件和加载动画插件（可选项）
    toast(option){
      const instance = Message.info(option);
      return ()=>{ // 返回一个用来关闭弹窗的方法
        instance.close();
      }
    }
    loading(options){
    	Loading.service(options)
    }
  }
})

在 modules 中配置接口基本信息

url 接口地址
method 请求方式
更多配置

export default {
  // 一个简单的url 配置
  fetchSomeData: {
    // 完整的访问方法名
    url: "/sample/data/normal", // 请求的地址（必填）
    // 以下皆为可选项
    mockUrl: "/mock/data/normal", // mock 地址（可选项）
    mockData: { rspCode: "success", data: [] }, // 静态 mock 数据
    cached: "5000", // 表示接口在多久以内，缓存临时数据（可选项）
    sensitive: "11", // 灵敏期，在这个时间段内，不会走缓存
    method: "POST", // 请求方法 post get（可选项）
    concurrency: false, // 是否允许并发（可选项）
    mock: false, // 是否访问 mock（可选项）， 若配置了全局mock 则仍然根据子项生效
    fit: (rsp, params) => {
      // 拦截返回数据格式化
      return rsp;
    },
    repeat: 3, // 重试次数
    feed: (rsp, params) => {
      // 补偿机制，如果重试无效，则进入兜底返回
      // 补偿机制
    },
    fail(rsp, params) {
      // 全局错误处理
    },
  },
};

在 api.js 中注册对应的模块，同时导出。

导出的变量名，既是最终使用时调用的名字。
如： api.brandHouse.fetch1(params, options)
其中 brandHouse 就是模块名
params 就是传给服务端的数据,例如

//服务端支持json数据,直接传json数据，不用修改请求header
api.brandHouse.fetch1(
  {
    bcd: 123,
    abc: 1344,
  },
  options
);
//若服务端不支持json数据, 直接在headers 中修改 content type
// 该配置同样可以在 全局配置中生效
api.brandHouse.fetch1(
   {a: 1 b:2},
   {
     headers: {
       'Content-Type': 'application/x-www-form-urlencoded'
     }
   }
);