跳至正文

API 工作流指南

你想构建什么?

选择最接近您工作的选项。每个路径都会为您提供一个可工作的请求、响应应包含的内容、如何检查其是否有效以及下一个有用的步骤。

五条实用路径

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

Selected: Receive live updates

您的 14 天 API 试用

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

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

检查 API 进度

第 0 天

验证访问权限

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

打开步骤 →

天 1-2

使请求具有可靠性

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

打开步骤 →

第 3-4 天

添加发布时间

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

打开步骤 →

天 5-7

构建研究输出

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

打开步骤 →

天 8-10

自动化更新

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

打开步骤 →

天数 11-13

加固客户端

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

打开步骤 →

14 日

查看证据

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

打开步骤 →

Real-time workflow

Receive release updates

A long-lived event stream can notify your application when matching macro data changes. The event is the trigger; the announcements endpoint remains the source for the full response.

20 minutes Application workflow stream公告

工作示例

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

curl -N --get \
  "https://api.fxmacrodata.com/v1/stream/events" \
  --data-urlencode "currencies=eur" \
  --data-urlencode "indicators=inflation" \
  --data-urlencode "api_key=$FXMD_API_KEY"

预期结果: A persistent filtered stream. When an event arrives, your worker fetches the related announcements endpoint and updates its local cache.

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

故障排除和生产指南

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

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