第 0 天
證明權限
創建金鑰，完成一次經過身份驗證的請求，並保存首次響應及其元數據。
開啟步驟 →API 工作流程指南
您想要構建什麼？
選擇最接近您工作的結果。每條路徑會提供一個可運行的請求、回應應包含的內容、如何檢查是否成功以及下一個有用步驟。
五條實用路徑
從結果開始，而不是從端點列表開始。
Selected: Plan release jobs
您的 14 天 API 試用
從第一次請求轉變為一份值得保留的工作。
目標不是訪問每個產品頁面。而是完成有用的經過身份驗證的 API 工作，在另一天返回，並帶著可重複的數據集或應用程序工作流離開。
天數 1-2
使請求可靠
解決身份驗證或篩選問題，並將第一個腳本轉化為具名的可重複作業。
開啟步驟 →第 3-4 天
添加發佈時間
將日曆用作第二個端點系列，並排定下一次有用的 API 執行時間。
開啟步驟 →天數 5-7
構建研究輸出
添加預期或一小組宏觀系列，然後生成一個保存的比較、表格或計分卡。
開啟步驟 →天數 8-10
自動化更新
選擇排定的 REST、SSE 或 webhooks，並在不同日期完成另一次成功的 API 運行。
開啟步驟 →天數 11-13
強化客戶端
添加超時、有界重試、回應驗證、憑據安全日誌記錄和陳舊數據監控。
開啟步驟 →天 14
審查證據
確認 API 提供了一個您的團隊將保留的可重複工作，然後選擇下一個數據集或應用工作流。
開啟步驟 →Scheduled workflow
Plan around confirmed releases
The calendar tells your scheduler when a release is expected. Your job can then fetch the full announcement record after publication instead of polling every series continuously.
運行示例
將您的金鑰保留在 FXMD_API_KEY; 絕不要將其貼入源控制系統。
from datetime import date, timedelta
import os
import requests
events = requests.get(
"https://api.fxmacrodata.com/v1/calendar/eur",
params={
"api_key": os.environ["FXMD_API_KEY"],
"start_date": date.today().isoformat(),
"end_date": (date.today() + timedelta(days=14)).isoformat(),
"timezone": "UTC",
},
timeout=20,
).json()["data"]
print(events[:3])預期結果： Upcoming EUR releases with dates, times, indicator paths, and confirmation fields that your scheduler can evaluate before creating a job.
當第一個腳本變成一個真實系統時
故障排除與生產環境指南
當響應失敗、未返回數據或需要生產控制（如緩存、超時、重試和事件交付）時，請使用這些指南。