mirror of
https://github.com/GMWalletApp/epusdt.git
synced 2026-07-07 18:26:16 +00:00
line-6000
104 lines
2.3 KiB
Markdown
104 lines
2.3 KiB
Markdown
# API 变更文档
|
||
|
||
## 概述
|
||
|
||
## 后台配置说明（重要）
|
||
|
||
### 对于 dujiaoka 用户
|
||
|
||
**只需要修改一个地方**：在 dujiaoka 后台支付插件配置中，将 API 地址前缀从 `/api` 改为 `/payments/epusdt` 即可。
|
||
|
||
**示例**：
|
||
|
||
```
|
||
旧配置：https://your-domain.com/api/v1/order/create-transaction
|
||
新配置：https://your-domain.com/payments/epusdt/v1/order/create-transaction
|
||
```
|
||
|
||
**就这么简单！** 其他配置（密钥、回调地址等）完全不需要修改。
|
||
|
||
---
|
||
|
||
## 路由变更对照表
|
||
|
||
### API 路由
|
||
|
||
| 原路由 | 新路由 | 说明 |
|
||
|--------|--------|------|
|
||
| `POST /api/v1/order/create-transaction` | `POST /payments/epusdt/v1/order/create-transaction` | 创建交易订单 |
|
||
|
||
|
||
## 新增配置项说明
|
||
|
||
本次更新新增了以下配置项（位于 `src/.env.example` 文件）：
|
||
|
||
### 1. `api_rate_url` - 汇率接口 URL
|
||
|
||
用于获取实时汇率的 API 地址。系统会根据此接口动态获取不同币种的汇率。
|
||
|
||
```bash
|
||
# 汇率接口url
|
||
api_rate_url=https://your-rate-api.com/
|
||
```
|
||
|
||
**API 格式要求**：
|
||
|
||
系统会请求 `{api_rate_url}/{currency}.json`，例如：
|
||
- `https://your-rate-api.com/cny.json`
|
||
- `https://your-rate-api.com/usd.json`
|
||
|
||
**返回格式示例**：
|
||
|
||
```json
|
||
{
|
||
"cny": {
|
||
"usdt": 0.1389,
|
||
"trx": 0.0123
|
||
}
|
||
}
|
||
```
|
||
|
||
其中 `0.1389` 表示 1 CNY = 0.1389 USDT（即 1 USDT ≈ 7.2 CNY）
|
||
|
||
**说明**：
|
||
- 支持自建汇率 API，只需按照上述格式返回数据即可
|
||
|
||
### 2. `tron_grid_api_key` - TRON Grid API Key
|
||
|
||
TRON Grid API 密钥，用于提高 API 请求限制和稳定性。
|
||
|
||
```bash
|
||
tron_grid_api_key=
|
||
```
|
||
|
||
**如何获取 API Key**：
|
||
|
||
1. 访问 [https://www.trongrid.io/](https://www.trongrid.io/)
|
||
2. 注册账号并登录
|
||
3. 在控制台创建 API Key
|
||
4. 将 API Key 填入配置文件
|
||
|
||
**为什么需要 API Key**：
|
||
|
||
- ✅ **提高请求限制**：免费账号有更高的 API 调用配额
|
||
- ✅ **更好的稳定性**：避免公共 API 的限流问题
|
||
- ✅ **支持更多功能**：为后续支持 TRX 等其他代币做准备
|
||
|
||
### 配置示例
|
||
|
||
`.env` 配置示例：
|
||
|
||
```bash
|
||
# 订单过期时间（分钟）
|
||
order_expiration_time=15
|
||
|
||
# 订单回调失败最大重试次数
|
||
order_notice_max_retry=0
|
||
|
||
# 汇率接口url（动态获取汇率）
|
||
api_rate_url=
|
||
|
||
# TRON Grid API Key（推荐配置）
|
||
tron_grid_api_key=your-api-key-here
|
||
```
|