快速开始
实时汇率
live 端点提供多种货币的当前汇率即时访问，支持实时金融计算和市场监控。货币转换
convert 端点使用最新汇率在货币之间转换特定金额，非常适合金融应用和电商平台。可用货币符号
symbols 端点提供支持货币的完整目录及详细描述，便于在应用中动态选择货币和验证。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 | 服务器不可用。 |