1、全局说明

## 一、接口统一请求

### 1、head规范
head必须带有device（都是小写），代表当前请求来自的平台。
![](/media/202306/2023-06-19_111902_4241360.23353876954361708.png)

### 2、返回格式
status：代表业务是否成功，一般作为判断依据。
code：作为status的补充，code可以作为更细致的判断。
```json
{
    "status":true,
    "code":200,
    "message":"提示",
    "data":{
        "key":"value"
    }
}
```

```javascript

// 大概逻辑是：
res = 返回结果
if(res.status){
	if(res.code == 200){
		逻辑1
	}else if(res.code = 201){
		逻辑2
	}
}else{
	toast(res.message)
}
```

### 3、请求封装
1、目前移动端的request封装是：
```javascript
function request(url, data = {}, method = 'GET') {
	return new Promise(function(resolve, reject) {
		uni.request({
			url,
			data,
			method,
			header: {
				'Content-Type': 'application/json',
				token: uni.getStorageSync('token'),
				played: uni.getStorageSync('played'),
				fromUser: uni.getStorageSync('form_user'),
				safeCode: uni.wen.api.safeCode,
				// #ifdef MP
				device: 'mp',
				// #endif
				// #ifdef H5
				device: 'h5',
				// #endif
				// #ifdef APP
				device: 'app',
				// #endif
			},
			success: function(res) {
				// console.log('===============请求数据==================');
				// console.log("url",url)
				// console.log("请求data：", JSON.stringify(data))
				// console.log("res",res)
				// console.log('-----------------------------------------');
				uni.hideLoading();
				if (res.statusCode == 200) {
					if (res.data.code == 503002) {
						if(uni.$store.state.scene == 14){
							return;
						}
						uni.wen.toUrl(6, '/pages/common/login', null);
					} else if (res.data.code == 503003) {
						//token过期
						// #ifdef MP
						getNewToken().then(() => {
							request(url, data, method).then((res) => {
								resolve(res);
							});
						});
						// #endif

// #ifndef MP
						//非小程序 ，token过期的话，就直接跳登录
						console.log("token过期 跳登录11")
						uni.clearStorageSync("token");
						uni.clearStorageSync("userInfo");

debounce(function() {
							console.log("token过期 跳登录22")
							if(uni.$store.state.scene == 14){
								return;
							}
							uni.wen.toUrl(6, '/pages/common/login', null);
						}, 1000)
						// #endif
					} else {
						resolve(res.data);
					}
				} else {
					reject(res.errMsg);
				}
			},
			fail: function(err) {
				if(method == 'POST'){
					uni.$store.commit('updatePostingUrl', '');
				}
				console.log("request err", err, url)
				reject(err);
			}
		});
	});
}
```
2、上传文件封装
```javascript
function uploadFile(url, filePath, scene) {
	let that = this;
	return new Promise(function(resolve, reject) {
		uni.uploadFile({
			url: url,
			filePath: filePath,
			name: 'file',
			header: {
				token: uni.getStorageSync('token'),
				played: uni.getStorageSync('played'),
				safeCode: uni.wen.api.safeCode,
				// #ifdef MP
				device: 'mp',
				// #endif
				// #ifdef H5
				device: 'h5',
				// #endif
				// #ifdef APP
				device: 'app',
				// #endif
				scene: scene
			},
			success: function(res) {
				uni.hideLoading();
				let data = JSON.parse(res.data);
				if (res.statusCode == 200) {
					if (data.code == 503002) {
						if(uni.$store.state.scene == 14){
							return;
						}
						uni.wen.toUrl(6, '/pages/common/login', null);
					} else if (data.code == 503003) {
						//token过期
						// #ifdef MP
						getNewToken().then(() => {
							uploadFile(url, filePath, scene).then((res) => {
								resolve(res);
							});
						});
						// #endif

// #ifndef MP
						//非小程序 ，token过期的话，就直接跳登录
						console.log("token过期 跳登录11")
						uni.clearStorageSync("token");
						uni.$store.commit('updateUserInfo', {});
						
						debounce(function() {
							console.log("token过期 跳登录22")
							if(uni.$store.state.scene == 14){
								return;
							}
							uni.wen.toUrl(6, '/pages/common/login', null);
						}, 1000)
						// #endif
					} else {
						resolve(data);
					}
				} else {
					reject(res.errMsg);
				}
			},
			fail: function(err) {
				reject(err);
			}
		});
	});
}
```

更多可以查看示例：（移动端前端代码）
![](/media/202306/2023-06-19_112949_2398950.7805052854895206.png)