跳至正文

API 工作流指南

你想构建什么?

从研究工作流和电子表格开始,或者遵循 API 指南来构建您自己的应用程序。

Choose your next step

Put macro data to work.

从研究工作流开始

选择一个起点,审查证据,并保留一个可以重建的工作簿。

入门访问 · USD 宏观

通胀监测器

追踪 US 头条和核心通胀,以及 EUR/USD。

打开工作流
需要订阅

央行政策比较

将 US 和欧元区政策利率与 EUR/USD 进行比较。

打开工作流
需要订阅

发布与修订审查

检查保留的 US 通胀发布、数值及发布证据。

打开工作流

选择计划前请检查覆盖范围。已经在用电子表格集成功能了吗?请遵循 Excel 指南 或 Google Sheets 指南 用于受支持的功能和刷新行为。

正在评估 API ? 检查受限的历史开发者样本 及其响应字段。

五条实用路径

从结果开始,而不是从终点列表开始。

Selected: Harden a client

您的 14 天 API 试用

从首次请求转变为值得保留的任务。

目标不是访问每一个产品页面。目标是完成有用的、经过身份验证的 API 工作,在另一天返回,并带着可重复的数据集或应用工作流离开。

检查 API 进度

第 0 天

验证访问权限

创建密钥,完成一次身份验证请求,并保存第一个带有其元数据的响应。

打开步骤 →

天 1-2

使请求具有可靠性

解决身份验证或过滤器问题,并将第一个脚本转化为命名的可重复任务。

打开步骤 →

第 3-4 天

添加发布时间

将日历作为第二个端点系列,并调度下一个有用的 API 运行。

打开步骤 →

天 5-7

构建研究输出

添加预期或一小组宏观序列,然后生成一个保存的对比、表格或计分卡。

打开步骤 →

天 8-10

自动化更新

选择计划内的 REST、SSE 或 Webhooks,并在另一天完成另一次成功的 API 运行。

打开步骤 →

天数 11-13

加固客户端

添加超时、有限重试、响应验证、凭据安全日志记录以及陈旧数据监控。

打开步骤 →

14 日

查看证据

确认 API 提供了一个您的团队将持续使用的可重复任务,然后选择下一个数据集或应用工作流。

打开步骤 →

Production readiness

使 API 客户端达到生产就绪状态

Production reliability comes from treating status codes differently, keeping retries bounded, reusing ETags, and choosing scheduled REST, SSE, or webhooks for the job.

25 minutes Production pattern 公告changesstreamwebhooks

工作示例

将您的密钥保存在 FXMD_API_KEY; 切勿将其粘贴到源代码控制中。

import os
import requests
from urllib3.util.retry import Retry

session = requests.Session()
retry = Retry(total=3, backoff_factor=0.5, status_forcelist=(429, 502, 503, 504))
session.mount("https://", requests.adapters.HTTPAdapter(max_retries=retry))

response = session.get(
    "https://api.fxmacrodata.com/v1/announcements/eur/inflation",
    params={"limit": 5},
    headers={"X-API-Key": os.environ["FXMD_API_KEY"], "Accept-Encoding": "gzip"},
    timeout=(3.05, 20),
)
response.raise_for_status()

预期结果: A bounded client that handles transient failures without retry storms and is ready to add ETag-based conditional refreshes.

当第一个脚本变成一个真正的系统时

故障排除和生产指南

当响应失败、未返回数据或需要生产控制(如缓存、超时、重试和事件传递)时,请使用这些指南。

指南在以下情况使用开始
诊断失败或空的响应 在不暴露密钥的情况下,分离身份验证、访问、路径、速率限制和数据可用性问题。 打开指南 →
使 API 客户端达到生产就绪状态 添加超时、有界重试、缓存、条件请求和正确的交付模式。 打开指南 →