基本信息
接口名称：
货币汇率转换
请求方法：
GET
计费类型：
免费
接口文档
# 汇率转换API文档
---
## 1. 基础信息
| 项 | 说明 |
|---------------|----------------------------------------------------------------------|
| 接口地址 | `https://api.logoi.cn/api/exchange` （或实际部署的 `/api.php` 路径） |
| 请求方式 | GET / POST 均可（表单、JSON、x-www-form-urlencoded 全部支持） |
| 返回格式 | JSON |
| 字符编码 | UTF-8 |
| 是否需要签名 | 否 |
---
## 2. 公共请求参数
| 参数名 | 类型 | 必填 | 说明 |
|--------|--------|------|----------------------------------------------------------------------|
| type | string | 是 | `list` 获取币种列表；`get` 进行汇率换算 |
---
## 3. 业务参数（仅 type=get 时必填）
| 参数名 | 类型 | 必填 | 说明 |
|--------|--------|------|----------------------------------------------------------------------|
| before | string | 是 | 源币种代码，如 `CNY` |
| after | string | 是 | 目标币种代码，如 `USD` |
| price | float | 是 | 需要换算的金额，必须 > 0 |
---
## 4. 返回字段
| 字段名 | 类型 | 出现场景 | 说明 |
|---------------|--------|----------|----------------------------------------------------------------------|
| code | int | 始终 | 状态码，`200` 成功，其余见下方「错误码」 |
| msg | string | 始终 | 状态描述 |
| before | string | type=get | 源币种 |
| after | string | type=get | 目标币种 |
| beforeprice* | string | type=get | 转换前金额 |
| resultprice | float | type=get | 转换后金额 |
| list | array | type=list| 币种列表，双元素数组 `[代码, 中文名]` |
---
## 5. 正确示例
### 5.1 获取币种列表
**请求**
```
GET /api.php?type=list
```
**返回**
```json
{
"code": 200,
"msg": "获取币种列表成功",
"list": [
["USD", "美元"],
["CNY", "人民币"],
["EUR", "欧元"],
...
]
}
```
### 5.2 汇率换算
**请求**
```
GET /exchange?type=get&before=CNY&after=USD&price=100
```
**返回**
```json
{
"code": 200,
"msg": "转换成功",
"before": "CNY",
"after": "USD",
"beforeprice": "100",
"resultprice": 14.1,
"api_source": "官方API网:https://api.logoi.cn/"
}
```
---
## 6. 错误码
| HTTP 状态 | code | 含义说明（msg 里会有详情） |
|-----------|------|---------------------------------------------|
| 400 | ≠200 | 参数缺失、币种不支持、金额≤0 等 |
| 500 | — | 本机网络错误 / 服务不可用 / 解析异常 |
---
## 7. 调用限制
- 免费使用，无需注册。
---
## 8. 快速调试
```bash
# 币种列表
curl "https://api.logoi.cn/exchange?type=list"
# 换算
curl "https://api.logoi.cn/exchange?type=get&before=CNY&after=USD&price=100"
```
---
请求参数
| 参数名 | 是否必填 | 类型 | 参数说明 | 示例值 |
|---|---|---|---|---|
| type | 是 | string | 获取模式,如不知道货币缩写则输入list即可查看 | get |
| before | 是 | string | 转换前货币 | USD |
| after | 是 | string | 转换后货币 | CNY |
| price | 是 | string | 转换金额 | 100 |
请求示例
{
"type": "get",
"before": "USD",
"after": "CNY",
"price": "100"
}
返回参数
| 参数名 | 类型 | 说明 |
|---|
返回示例
[]