## 安装
### web 端
#### 安装本体
```bash
$ npm i -S tua-api
# OR
$ yarn add tua-api
```
然后直接导入即可
```js
import TuaApi from 'tua-api'
```
#### 配置武器
配置“武器”分为两种情况:
* [已配置 CORS 跨域请求头](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Access_control_CORS)，或是没有跨域需求时，无需任何操作（默认采用的就是 `axios`）。
* 若是用不了 CORS，那么就需要设置 `reqType: 'jsonp'` 借助 jsonp 实现跨域
但是 jsonp 只支持使用 get 的方式请求，所以如果需要发送 post 或其他方式的请求，还是需要使用 `axios`（服务端还是需要配置 CORS）。
### 小程序端
#### 安装本体即可
```bash
$ npm i -S tua-api
# OR
$ yarn add tua-api
```
```js
import TuaApi from 'tua-api'
```
> 小程序还用不了 npm？[@tua-mp/service](https://tuateam.github.io/tua-mp/tua-mp-service/) 了解一下？
## `tua-api` 能干什么？
`tua-api` 能实现统一管理 api 配置（例如一般放在 `src/apis/` 下）。经过处理后，业务侧代码只需要这样写即可：
```js
import { fooApi } from '@/apis/'
fooApi
.bar({ a: '1', b: '2' }) // 发起请求，a、b 是请求参数
.then(console.log) // 收到响应
.catch(console.error) // 处理错误
```
不仅如此，还有一些其他功能：
* 参数校验
* 默认参数
* 中间件（koa 风格）
* ...
```js
// 甚至可以更进一步和 tua-storage 配合使用
import TuaStorage from 'tua-storage'
import { getSyncFnMapByApis } from 'tua-api'
// 本地写好的各种接口配置
import * as apis from '@/apis'
const tuaStorage = new TuaStorage({
syncFnMap: getSyncFnMapByApis(apis),
})
const fetchParam = {
key: fooApi.bar.key,
syncParams: { a: 'a', b: 'b' },
// 过期时间，默认值为实例化时的值，以秒为单位
expires: 10,
// 是否直接调用同步函数更新数据，默认为 false
// 适用于需要强制更新数据的场景，例如小程序中的下拉刷新
isForceUpdate: true,
// ...
}
tuaStorage
.load(fetchParam)
.then(console.log)
.catch(console.error)
```
## 怎么写 `api` 配置？
拿以下 api 地址举例：
* `https://example-base.com/foo/bar/something/create`
* `https://example-base.com/foo/bar/something/modify`
* `https://example-base.com/foo/bar/something/delete`
### 地址结构划分
以上地址，一般将其分为`3`部分：
* baseUrl: `'https://example-base.com/foo/bar'`
* prefix: `'something'`
* pathList: `[ 'create', 'modify', 'delete' ]`
### 文件结构
`api/` 一般是这样的文件结构：
```
.
└── apis
├── prefix-1.js
├── prefix-2.js
├── something.js // <-- 以上的 api 地址会放在这里，名字随意
└── index.js
```
### 基础配置内容
```js
// src/apis/something.js
export default {
// 接口基础地址
baseUrl: 'https://example-base.com/foo/bar',
// 接口的中间路径
prefix: 'something',
// 接口地址数组
pathList: [
{ path: 'create' },
{ path: 'modify' },
{ path: 'delete' },
],
}
```
[更多配置请点击这里查看](https://tua-api.pages.woa.com/config/common.html)
### 配置导出
最后来看一下 `apis/index.js` 该怎么写：
```js
import TuaApi from 'tua-api'
// 初始化
const tuaApi = new TuaApi({ ... })
// 使用中间件
tuaApi
.use(async (ctx, next) => {
// 请求发起前
console.log('before: ', ctx)
await next()
// 响应返回后
console.log('after: ', ctx)
})
// 链式调用
.use(...)
export const fakeGet = tuaApi.getApi(require('./fake-get').default)
export const fakePost = tuaApi.getApi(require('./fake-post').default)
```
小程序端建议使用 [@tua-mp/cli](https://tuateam.github.io/tua-mp/tua-mp-cli/) 一键生成 api。
```bash
$ tuamp add api  StEve Young 💻 📖 🚇 |
 evinma 💻 |