コンテンツへスキップ

API ワークフローガイド

何を作成したいですか?

あなたの業務に最も近い結果を選択してください。各パスには、1つの実行可能なリクエスト、レスポンスに含めるべき内容、動作確認方法、および次の有用なステップが示されています。

5つの実用的なパス

エンドポイントのリストではなく、結果から始めてください。

選択済み: マクロデータを取得

あなたの 14 日間 API トライアル

最初のリクエストから、価値のあるジョブへと移行しましょう。

目標は、すべての製品ページを訪問することではありません。有用な認証済み API 作業を完了し、別の日に戻ってきて、再現可能なデータセットまたはアプリケーションワークフローを持って去ることです。

API の進捗を確認

日 0

アクセスを証明

キーを作成し、認証済みリクエストを1回完了させ、最初のレスポンスをそのメタデータと共に保存してください。

ステップを開く →

日数 1-2

リクエストを信頼できるものにする

認証またはフィルターの問題を解決し、最初のスクリプトを名前付きの繰り返し可能なジョブに変換します。

ステップを開く →

日 3-4

リリース時期を追加

カレンダーを第2のエンドポイントファミリーとして使用し、次に有用な API 実行をスケジュールします。

ステップを開く →

日数 5-7

リサーチ出力を構築

期待値または少数のマクロシリーズを追加し、保存された比較、テーブル、またはスコアカードを1つ作成します。

ステップを開く →

日数 8-10

更新を自動化

スケジュールされた REST、SSE、または Webhook を選択し、別の日に別の API 実行を成功させてください。

ステップを開く →

日数 11-13

クライアントを強化する

タイムアウト、制限付きリトライ、レスポンス検証、認証情報に安全なロギング、および古いデータのモニタリングを追加します。

ステップを開く →

日 14

エビデンスを確認

API がチームが継続して利用する反復可能なジョブを提供することを確認してから、次のデータセットまたはアプリケーションワークフローを選択してください。

ステップを開く →

最初のリクエスト

マクロ履歴の取得と保存

まずは、すでに理解している1つの通貨と指標から始めてください。これにより、より多くのシリーズを追加する前に、認証、レスポンス形式、ページネーション、およびストレージを簡単に検証できます。

10 分 ここから開始 発表

動作例

キーを以下に保持 FXMD_API_KEY; ソース管理には決して貼り付けないでください。

import os
import requests

response = requests.get(
    "https://api.fxmacrodata.com/v1/announcements/eur/inflation",
    params={"api_key": os.environ["FXMD_API_KEY"], "limit": 5},
    timeout=20,
)
response.raise_for_status()
payload = response.json()
print(payload["data"][0])

期待される結果: 直近の EUR インフレ観測値と、シリーズ、ソース、ページネーション、およびデータ品質を説明するレスポンスメタデータを含む 200 レスポンス。

最初のスクリプトが本物のシステムになるとき

トラブルシューティングおよび本番環境向けガイダンス

レスポンスの失敗、データの未返却、またはキャッシュ、タイムアウト、リトライ、イベント配信などの本番環境用コントロールが必要な場合は、これらのガイドを使用してください。

ガイド使用する場合開始
失敗した、または空のレスポンスの診断 キーを公開することなく、認証、アクセス、パス、レート制限、およびデータ可用性の問題を分離します。 ガイドを開く →
API クライアントをプロダクション対応にする タイムアウト、制限付きリトライ、キャッシュ、条件付きリクエスト、および適切な配信パターンを追加します。 ガイドを開く →