> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 简介

> Cleariflow 汇率 API 通过简洁、现代化的 RESTful JSON 接口提供实时货币转换——支持 80 多种全球货币、实时汇率和即时换算。

## 快速开始

<Card title="实时汇率" icon="activity" href="exchange-rates/live">
  `live` 端点提供多种货币的当前汇率即时访问，支持实时金融计算和市场监控。
</Card>

<Card title="货币转换" icon="arrow-left-right" href="exchange-rates/convert">
  `convert` 端点使用最新汇率在货币之间转换特定金额，非常适合金融应用和电商平台。
</Card>

<Card title="可用货币符号" icon="circle-dollar-sign" href="exchange-rates/symbols">
  `symbols` 端点提供支持货币的完整目录及详细描述，便于在应用中动态选择货币和验证。
</Card>

### REST 架构

汇率 API 遵循 REST 原则，采用可预测的资源导向 URL 和标准 HTTP 状态码，实现无缝集成和错误处理。

### HTTPS 安全

所有 API 通信均使用 TLS 1.2 或更高版本的加密协议进行保护，确保数据完整性和隐私。

### API 版本控制

汇率 API 通过版本控制保持向后兼容，当前运行在第 1 版，并计划未来增强。

### 身份验证

API 密钥是访问汇率 API 的唯一凭证。每个 Cleariflow 服务需要唯一的密钥，确保不同 API 之间的安全隔离访问。

## 响应和错误代码

请求失败时，API 返回结构化的 JSON 错误响应，包含特定代码和描述，便于有效排查问题。

| Code | Type                  | Details                             |
| ---- | --------------------- | ----------------------------------- |
| 200  | OK                    | 一切按预期运行。                            |
| 204  | OK                    | 提交的 IP 没有位置数据。                      |
| 400  | Bad request           | 错误请求。                               |
| 401  | Unauthorized          | 请求不可接受。通常由于 API 密钥缺失或不正确。           |
| 422  | Quota reached         | 由于 API 积分不足，请求被中止。（免费计划）            |
| 429  | Too many requests     | 由于达到每秒允许请求数，请求被中止。免费计划的请求限制为每秒 1 次。 |
| 500  | Internal server error | 由于服务器端错误，无法完成请求。                    |
| 503  | Service unavailable   | 服务器不可用。                             |