はじめに

はじめに

ライブ為替レート

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	サーバーが利用できませんでした。