三网折扣话费充值接口文档

**三网折扣话费充值接口文档**

**版本:**1.0**日期:**2023-03-01**概述:**

本文档描述了三网折扣话费充值接口的设计、实现和使用方法。该接口用于实现用户在三网平台上进行折扣话费充值。

**接口定义:**

### **POST /recharge**

#### **请求参数:**

| 参数名称 | 类型 | 必须 | 描述 |
| --- | --- | --- | --- |
| `phone` | string | 是 | 用户手机号码 |
| `amount` | number | 是 | 充值金额 |
| `discount` | number | 否 | 折扣率（默认为0） |

#### **响应参数:**

| 参数名称 | 类型 | 必须 | 描述 |
| --- | --- | --- | --- |
| `code` | string | 是 | 响应码 |
| `message` | string | 是 | 响应消息 |
| `data` | object | 否 | 充值结果 |

#### **示例请求:**

bashPOST /recharge HTTP/1.1Content-Type: application/json{
 "phone": "13888888888",
 "amount":100,
 "discount":10}

#### **示例响应:**

json{
 "code": "200",
 "message": "充值成功",
 "data": {
 "rechargeId": "1234567890"
 }
}

### **GET /recharge/{rechargeId}**

#### **请求参数:**

| 参数名称 | 类型 | 必须 | 描述 |
| --- | --- | --- | --- |
| `rechargeId` | string | 是 | 充值ID |

#### **响应参数:**

| 参数名称 | 类型 | 必须 | 描述 |
| --- | --- | --- | --- |
| `code` | string | 是 | 响应码 |
| `message` | string | 是 | 响应消息 |
| `data` | object | 否 | 充值结果 |

#### **示例请求:**

bashGET /recharge/1234567890 HTTP/1.1

#### **示例响应:**

json{
 "code": "200",
 "message": "查询成功",
 "data": {
 "phone": "13888888888",
 "amount":100,
 "discount":10,
 "status": "success"
 }
}

### **PUT /recharge/{rechargeId}**

#### **请求参数:**

| 参数名称 | 类型 | 必须 | 描述 |
| --- | --- | --- | --- |
| `rechargeId` | string | 是 | 充值ID |
| `status` | string | 否 | 充值状态（默认为 success） |

#### **响应参数:**

| 参数名称 | 类型 | 必须 | 描述 |
| --- | --- | --- | --- |
| `code` | string | 是 | 响应码 |
| `message` | string | 是 | 响应消息 |
| `data` | object | 否 | 充值结果 |

#### **示例请求:**

bashPUT /recharge/1234567890 HTTP/1.1Content-Type: application/json{
 "status": "failed"
}

#### **示例响应:**

json{
 "code": "200",
 "message": "更新成功",
 "data": {
 "phone": "13888888888",
 "amount":100,
 "discount":10,
 "status": "failed"
 }
}

### **DELETE /recharge/{rechargeId}**

#### **请求参数:**

| 参数名称 | 类型 | 必须 | 描述 |
| --- | --- | --- | --- |
| `rechargeId` | string | 是 | 充值ID |

#### **响应参数:**

| 参数名称 | 类型 | 必须 | 描述 |
| --- | --- | --- | --- |
| `code` | string | 是 | 响应码 |
| `message` | string | 是 | 响应消息 |
| `data` | object | 否 | 充值结果 |

#### **示例请求:**

bashDELETE /recharge/1234567890 HTTP/1.1

#### **示例响应:**

json{
 "code": "200",
 "message": "删除成功",
 "data": {}
}

**注意:** 本文档仅供参考，具体实现和使用方法请根据实际需求进行调整。

**更新记录:**

*2023-03-01: 初始版本**联系方式:**

如果您有任何问题或建议，请通过以下方式联系我们：

* 邮箱：[support@example.com](mailto:support@example.com)
* QQ：1234567890* 微信：example