first commit

历届学生/陈一航/项目/shop/shop_backend/header.md

@@ -0,0 +1,48 @@
+---
+
+## 【注意】使用注意事项
+
+1：前端接口使用`公钥`进行数据的加解密操作，并将数据放到自定义请求头`data`中进行传递给后端，主要前端加解密逻辑在`api/index.js`的拦截器中实现
+
+2：用户登录注册的时候发送接口，请求头中不需要`jwt`的`token`字段。用户登录成功后，登录接口会返回`token`参数。请前端自己使用`localStorage.setItem`
+方法进行本地保存`token`字段。后端的所有接口在数据请求的时候需要在请求头携带`token`字段通过身份验证。
+
+3：有些接口没有参数的话，需要在调用`xxxService`的时候传入一个空的对象。例如请求首页接口
+
+```
+await this.$http.homeService.getHomeData({});  # getHomeData方法接口空对象: {}
+```
+
+RSA 非对称加密(可逆加密)
+
+MD5（不可逆）
+
+HTTPS加密
+支付
+
+JWT
+token  RGJHFBEJRHWBFJ23868734R874Y8723R23RU34R
+
+
+
+公钥 （前端）
+
+私钥（服务器）
+
+4：接口返回的数据格式如下：
+
+```
+{
+ "status" : 200,
+ "message" : "请求成功"
+ "result" : "asjXzXxmnSp8TZGWiTSlJF8Gb...5LhYoHs86SEI2LBXrTZ9e/a4frZOWHZ"
+}
+```
+
+- 4.1：status：主要作用标志请求是否成功，`200`表示接口请求成功无错误，`404`表示接口请求出现错误
+
+- 4.2：message：当 `status` 为 `200` 的时候值为：`请求成功`，当 `status` 为 `404` 的时候 `message`数值为具体的接口错误信息，前端只需要在全局ajax拦截器中`Toast`弹出`message`的错误信息即可
+
+- 4.3：result: 请求的所有数据都会在本字段中，本字段的数据会使用私钥进行加密，需要前端公钥解密数据后使用
+
+5：Ajax的请求方式一律使用`POST`接口，注意是`POST`！！！