简介 - Cleariflow API

快速开始

实时汇率

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	服务器不可用。