# photo-front

**Repository Path**: xiaogui918/photo-front

## Basic Information

- **Project Name**: photo-front
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-03
- **Last Updated**: 2025-08-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 📑 接口文档总表

## 1. 用户与登录相关

### 1.1 获取用户 Token  
- **接口**：`GET /easyLogin-userToken`  
- **参数**：无  
- **说明**：获取当前登录用户的 token。  

---

### 1.2 获取用户信息（通过 code）  
- **接口**：`GET /easyLogin/userinfo?code={code}`  
- **参数**：  
  - `code`：授权码  
- **说明**：根据授权码获取第三方登录的用户信息。  

---

### 1.3 获取用户 Token（通过 code）  
- **接口**：`GET /easyLogin/userToken?code={code}`  
- **参数**：  
  - `code`：授权码  
- **说明**：换取 access_token 和 client_id，保存到 localStorage。  

---

### 1.4 获取支持的授权平台  
- **接口**：`GET /easyLogin/authConfigList`  
- **参数**：无  
- **说明**：返回当前支持的第三方登录平台（QQ、微信、支付宝等）。  

---

### 1.5 获取登录用户信息（通过 token）  
- **接口**：`GET /system/user/getInfo`  
- **参数**：无（需带 token）  
- **说明**：根据本地保存的 access_token 获取用户资料（头像、昵称）。  

---

### 1.6 用户登出  
- **接口**：`GET /api/auth/logout`  
- **参数**：无  
- **说明**：登出并清除本地 token。  

---

## 2. 照片上传与下单

### 2.1 获取相片类型列表  
- **接口**：`POST /zp/goods/goodsList`  
- **参数**：  
  - `goodsCategoryCode: "IMG_ID"`  
- **说明**：获取证件照类型（如身份证、护照、签证等）。  

---

### 2.2 创建订单  
- **接口**：`POST /zp/order/createOrder`  
- **参数**：  
  ```json
  {
    "goodsCode": "相片类型编号",
    "province": "省份",
    "city": "城市",
    "pendingImgId": "上传的相片ID",
    "goodsCategoryCode": "IMG_ID"
  }
  ```
- **说明**：提交检测/下单，生成订单。  

---

### 2.3 上传照片  
- **接口**：`POST /api/zp/img/upload`  
- **参数**：`FormData`（文件：JPG/PNG，≤ 5MB 或 2MB）  
- **返回**：  
  ```json
  {
    "code": 200,
    "data": {
      "ossId": "文件ID",
      "url": "文件URL"
    }
  }
  ```
- **说明**：上传用户相片。  

---

## 3. 照片编辑功能

### 3.1 获取背景颜色列表  
- **接口**：`POST /zp/goods/goodsList`  
- **参数**：  
  - `goodsCategoryCode: "IMG_BACKGROUND"`  
- **说明**：获取所有背景颜色选项（蓝底、白底、红底）。  

---

### 3.2 获取尺寸列表  
- **接口**：`POST /zp/goods/goodsList`  
- **参数**：  
  - `goodsCategoryCode: "IMG_INCH"`  
- **说明**：获取证件照尺寸（1寸、2寸等）。  

---

### 3.3 获取排版列表  
- **接口**：`POST /zp/goods/goodsList`  
- **参数**：  
  - `goodsCategoryCode: "IMG_LAYOUT"`  
- **说明**：获取证件照排版模板（六寸多排）。  

---

### 3.4 修改背景颜色  
- **接口**：`POST /zp/img/changeImg`  
- **参数**：  
  ```json
  {
    "goodsCategoryCode": "IMG_BACKGROUND",
    "pendingImgUrl": "原图URL",
    "goodsCode": "背景色编号",
    "width": 100,
    "height": 100
  }
  ```
- **说明**：换背景色。  

---

### 3.5 修改尺寸  
- **接口**：`POST /zp/img/changeImg`  
- **参数**：  
  ```json
  {
    "goodsCategoryCode": "IMG_INCH",
    "pendingImgUrl": "原图URL",
    "goodsCode": "尺寸编号",
    "width": 宽,
    "height": 高
  }
  ```
- **说明**：修改证件照尺寸。  

---

### 3.6 修改排版  
- **接口**：`POST /zp/img/changeImg`  
- **参数**：  
  ```json
  {
    "goodsCategoryCode": "IMG_LAYOUT",
    "pendingImgUrl": "原图URL",
    "goodsCode": "排版编号",
    "width": 宽,
    "height": 高
  }
  ```
- **说明**：生成排版后的相片。  

---

# 📌 总结
一共 **14 个接口**：  
- 登录相关：6 个  
- 上传下单：3 个  
- 编辑功能：5 个