第 0 天
證明權限
創建金鑰，完成一次經過身份驗證的請求，並保存首次響應及其元數據。
開啟步驟 →API 工作流程指南
您想要構建什麼？
選擇最接近您工作的結果。每條路徑會提供一個可運行的請求、回應應包含的內容、如何檢查是否成功以及下一個有用步驟。
五條實用路徑
從結果開始，而不是從端點列表開始。
Selected: Measure surprises
您的 14 天 API 試用
從第一次請求轉變為一份值得保留的工作。
目標不是訪問每個產品頁面。而是完成有用的經過身份驗證的 API 工作，在另一天返回，並帶著可重複的數據集或應用程序工作流離開。
天數 1-2
使請求可靠
解決身份驗證或篩選問題，並將第一個腳本轉化為具名的可重複作業。
開啟步驟 →第 3-4 天
添加發佈時間
將日曆用作第二個端點系列，並排定下一次有用的 API 執行時間。
開啟步驟 →天數 5-7
構建研究輸出
添加預期或一小組宏觀系列，然後生成一個保存的比較、表格或計分卡。
開啟步驟 →天數 8-10
自動化更新
選擇排定的 REST、SSE 或 webhooks，並在不同日期完成另一次成功的 API 運行。
開啟步驟 →天數 11-13
強化客戶端
添加超時、有界重試、回應驗證、憑據安全日誌記錄和陳舊數據監控。
開啟步驟 →天 14
審查證據
確認 API 提供了一個您的團隊將保留的可重複工作，然後選擇下一個數據集或應用工作流。
開啟步驟 →Expectations workflow
Compare forecasts with actual releases
Use predictions before the event, preserve the forecast timestamp, then join the released observation by announcement identity for a repeatable surprise series.
運行示例
將您的金鑰保留在 FXMD_API_KEY; 絕不要將其貼入源控制系統。
import os
import requests
params = {
"api_key": os.environ["FXMD_API_KEY"],
"pre_release_only": "true",
"limit": 5,
}
response = requests.get(
"https://api.fxmacrodata.com/v1/predictions/eur/inflation",
params=params,
timeout=20,
)
response.raise_for_status()
print(response.json()["data"][0])預期結果： Recent EUR inflation release groups with source-labelled forecasts that were recorded before each announcement.
當第一個腳本變成一個真實系統時
故障排除與生產環境指南
當響應失敗、未返回數據或需要生產控制（如緩存、超時、重試和事件交付）時，請使用這些指南。