過去為替レート照会

APIの概要

過去為替レート照会APIは、特定通貨の過去一定期間における為替レートの変動状況を取得できるAPIです。通貨コードまたは通貨名、および対象の月またはカスタムの開始・終了日付を指定することで、その期間内の日次為替レート詳細データ（電信買/売相場、現金買/売相場、中国銀行換算レートなど）を返します。

利用シーン

• 財務決済と監査：企業がクロスボーダー取引の決済や財務監査を行う際、過去の特定日の為替レートを照合するのに役立ちます。
• データ分析とトレンド予測：金融アナリストや研究者が過去の為替データを利用して、市場トレンドの分析やモデル構築を行います。
• 越境ECプラットフォーム：ユーザーに過去の注文の為替レート参考情報を提供したり、内部の原価計算に使用したりします。
• 旅行・両替サービス：過去の為替レートの推移を表示し、ユーザーの両替戦略の策定をサポートします。

リクエストとレスポンスの説明

リクエストパラメータのポイント：

• 照会する通貨の指定が必要です。code（通貨コード、例：USD）または name（通貨名、例：米ドル）のいずれかを必ず指定してください。
• 照会する期間の指定が必要です。month（年月、フォーマット：yyyyMM）で指定するか、startDate と endDate（年月日、フォーマット：yyyyMMdd）を組み合わせて指定します。注意：月別照会と日付範囲照会を両方とも空にすることはできません。

レスポンス結果のポイント：

• レスポンスには、ステータスコード（code）、説明メッセージ（msg）、および一意のリクエスト番号（taskNo）が含まれます。
• コアデータは data オブジェクト内にあり、照会した通貨情報と期間が含まれます。
• list 配列には、指定期間内の日次為替レートの詳細が含まれます。具体的なフィールドは以下の通りです：
• publish_time：発表日
• middle_rate：中国銀行換算レート
• buying_rate：電信買相場
• selling_rate：電信売相場
• cash_buying_rate：現金買相場
• cash_selling_rate：現金売相場

導入の推奨事項

• 通貨名（name）の表記揺れによる照会エラーを防ぐため、通貨コード（code）を優先して使用することをお勧めします。
• リクエストを構築する際は、時間パラメータのフォーマット（yyyyMM または yyyyMMdd）が正しいことを確認し、月別照会と日付範囲照会の排他ロジックに注意してください。
• 広範囲の過去データを照会する場合は、業務のオフピーク時に実行するか、照会結果をローカルにキャッシュすることで、APIの呼び出し頻度を減らし、応答速度を向上させることを検討してください。
• APIが返す200以外のステータスコードを適切に処理し、msg フィールドに基づいて適切なエラー表示や再試行ロジックを実装してください。