Files
hcb-h5/uc_api.md
T
小鱼开发 f4d23e0083 hcb
2025-07-22 16:55:01 +08:00

422 lines
8.3 KiB
Markdown

---
title: 好车补h5
language_tabs:
- shell: Shell
- http: HTTP
- javascript: JavaScript
- ruby: Ruby
- python: Python
- php: PHP
- java: Java
- go: Go
toc_footers: []
includes: []
search: true
code_clipboard: true
highlight_theme: darkula
headingLevel: 2
generator: "@tarslib/widdershins v4.0.30"
---
# 好车补h5
Base URLs:
# Authentication
# 用户中心
## GET 我的优惠券
GET /auto/ucenter/coupons
> Body 请求参数
```yaml
{}
```
### 请求参数
|名称|位置|类型|必选|说明|
|---|---|---|---|---|
|page|query|integer| 否 |页码|
|size|query|integer| 否 |分页大小|
|Authorization|header|string| 是 |none|
|body|body|object| 否 |none|
> 返回示例
> 200 Response
```json
{
"code": 200,
"message": "操作成功",
"data": {
"list": [
{
"id": "645",
"sid": "350200030611174722101371",
"couponId": "645",
"title": "奇瑞舒享家补贴券",
"price": "1000.00",
"timeStart": "2025-06-01 00:00:00",
"timeEnd": "2025-07-31 00:00:00",
"rule": "点击近段时间阿萨德",
"bizTip": "适用 泉州惠安车卖场等 23家门店",
"typeCn": "购车补贴",
"btText": {
"txt": "立即使用",
"status": "0"
}
}
],
"count": 1
}
}
```
### 返回结果
|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
### 返回数据结构
状态码 **200**
|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer|true|none||none|
|» message|string|true|none||none|
|» data|object|true|none||none|
|»» list|[object]|true|none||none|
|»»» id|string|false|none||none|
|»»» sid|string|false|none||订单号|
|»»» couponId|string|false|none||none|
|»»» title|string|false|none||none|
|»»» price|string|false|none||none|
|»»» timeStart|string|false|none||none|
|»»» timeEnd|string|false|none||none|
|»»» rule|string|false|none||none|
|»»» bizTip|string|false|none||none|
|»»» typeCn|string|false|none||优惠券类型中文|
|»»» btText|object|false|none||按钮信息|
|»»»» txt|string|true|none||none|
|»»»» status|string|true|none||0待核销 1已核销 21已过期|
|»» count|integer|true|none||none|
## GET 用户中心
GET /auto/ucenter
> Body 请求参数
```yaml
{}
```
### 请求参数
|名称|位置|类型|必选|说明|
|---|---|---|---|---|
|Authorization|header|string| 是 |none|
|body|body|object| 否 |none|
> 返回示例
> 200 Response
```json
{
"code": 200,
"message": "操作成功",
"data": {
"user_info": {
"username": "",
"avatar": ""
},
"menu_list": [
{
"title": "我的券",
"type": 1,
"url": "/my/coupon"
},
{
"title": "我的订单",
"type": 1,
"url": "/my/order"
},
{
"title": "我的补贴",
"type": 1,
"url": "/my/allowance"
},
{
"title": "我的客服",
"type": 2,
"url": "13666668888"
}
]
}
}
```
### 返回结果
|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
### 返回数据结构
状态码 **200**
|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer|true|none||none|
|» message|string|true|none||none|
|» data|object|true|none||none|
|»» user_info|object|true|none||none|
|»»» username|string|true|none||none|
|»»» avatar|string|true|none||none|
|»» menu_list|[object]|true|none||none|
|»»» title|string|true|none||none|
|»»» type|integer|true|none||none|
|»»» url|string|true|none||none|
## GET 我的订单
GET /auto/ucenter/orders
> Body 请求参数
```yaml
{}
```
### 请求参数
|名称|位置|类型|必选|说明|
|---|---|---|---|---|
|page|query|integer| 否 |页码|
|size|query|integer| 否 |分页大小|
|Authorization|header|string| 是 |none|
|body|body|object| 否 |none|
> 返回示例
> 200 Response
```json
{
"code": 200,
"message": "操作成功",
"data": {
"list": [
{
"sid": "24234234234",
"title": "产品标题",
"logo": "",
"guide_price": 2000
}
],
"count": 1
}
}
```
### 返回结果
|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
### 返回数据结构
状态码 **200**
|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer|true|none||none|
|» message|string|true|none||none|
|» data|object|true|none||none|
|»» list|[object]|true|none||none|
|»»» sid|string|false|none||订单号|
|»»» title|string|false|none||none|
|»»» logo|string|false|none||none|
|»»» guide_price|integer|false|none||none|
|»» count|integer|true|none||none|
## GET 我的补贴
GET /auto/ucenter/subsidy
> Body 请求参数
```yaml
{}
```
### 请求参数
|名称|位置|类型|必选|说明|
|---|---|---|---|---|
|page|query|integer| 否 |页码|
|size|query|integer| 否 |分页大小|
|Authorization|header|string| 是 |none|
|body|body|object| 否 |none|
> 返回示例
> 200 Response
```json
{
"code": 200,
"message": "操作成功",
"data": {
"list": [
{
"id": 1,
"sid": "24234234234",
"title": "产品标题",
"logo": "",
"price": "10万",
"biz": "厦门4s店铺",
"car": "广汽丰田",
"step": 0,
"progress": [
"完成订单",
"提交资料",
"系统审核",
"发放完毕"
]
}
],
"count": 1
}
}
```
### 返回结果
|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
### 返回数据结构
状态码 **200**
|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer|true|none||none|
|» message|string|true|none||none|
|» data|object|true|none||none|
|»» list|[object]|true|none||none|
|»»» id|integer|false|none||none|
|»»» sid|string|false|none||订单号|
|»»» title|string|false|none||none|
|»»» logo|string|false|none||none|
|»»» price|string|false|none||none|
|»»» biz|string|false|none||none|
|»»» car|string|false|none||none|
|»»» step|integer|false|none||none|
|»»» progress|[string]|false|none||none|
|»» count|integer|true|none||none|
## POST 提交审核资料
POST /auto/subsidy
> Body 请求参数
```yaml
{}
```
### 请求参数
|名称|位置|类型|必选|说明|
|---|---|---|---|---|
|id|query|integer| 是 |补贴id|
|bizId|query|integer| 是 |门店id|
|cityId|query|string| 是 |城市id|
|brandId|query|integer| 是 |品牌id|
|seriesId|query|integer| 是 |车系id|
|billImg|query|string| 是 |发票图片地址|
|businessImg|query|string| 是 |商业保险单|
|Authorization|header|string| 是 |none|
|body|body|object| 否 |none|
> 返回示例
> 200 Response
```json
{
"code": 200,
"message": "操作成功",
"data": {
"list": [
{
"id": 1,
"sid": "24234234234",
"title": "产品标题",
"logo": "",
"price": "10万",
"biz": "厦门4s店铺",
"car": "广汽丰田",
"step": 0,
"progress": [
"完成订单",
"提交资料",
"系统审核",
"发放完毕"
]
}
],
"count": 1
}
}
```
### 返回结果
|状态码|状态码含义|说明|数据模型|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
### 返回数据结构
状态码 **200**
|名称|类型|必选|约束|中文名|说明|
|---|---|---|---|---|---|
|» code|integer|true|none||none|
|» message|string|true|none||none|
|» data|object|true|none||none|
|»» list|[object]|true|none||none|
|»»» id|integer|false|none||none|
|»»» sid|string|false|none||订单号|
|»»» title|string|false|none||none|
|»»» logo|string|false|none||none|
|»»» price|string|false|none||none|
|»»» biz|string|false|none||none|
|»»» car|string|false|none||none|
|»»» step|integer|false|none||none|
|»»» progress|[string]|false|none||none|
|»» count|integer|true|none||none|
# 数据模型