> ## 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以上のグローバル通貨のライブレートと即時換算をサポートします。
## はじめに
`live`エンドポイントは複数通貨の現在の為替レートへの即時アクセスを提供し、リアルタイムの金融計算と市場モニタリングを可能にします。
`convert`エンドポイントは最新の為替レートを使用して特定の金額を通貨間で換算します。金融アプリケーションやeコマースプラットフォームに最適です。
`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秒あたり1リクエストに制限されています。 |
| 500 | Internal server error | サーバー側のエラーによりリクエストを完了できませんでした。 |
| 503 | Service unavailable | サーバーが利用できませんでした。 |