Día 0
Probar acceso
Cree la clave, complete una solicitud autenticada y guarde la primera respuesta con sus metadatos.
Abrir paso →Guía de flujo de trabajo de API
¿Qué desea construir?
Elija el resultado más cercano a su trabajo. Cada ruta le brinda una solicitud funcional, lo que debe contener la respuesta, cómo verificar que funcionó y el siguiente paso útil.
Cinco rutas prácticas
Comience con el resultado, no con la lista de endpoints.
Selected: Measure surprises
Ruta 1
Obtener datos macro
Recupere una serie temporal limpia y mantenga los metadatos de origen y calidad junto a ella.
Ruta 2
Planificar trabajos de publicación
Use el calendario de lanzamientos para ejecutar trabajos específicos en torno a los horarios de publicación conocidos.
Ruta 3
Medir sorpresas
Una los pronósticos previos a la publicación con el valor publicado sin introducir sesgo de anticipación.
Ruta 4
Recibir actualizaciones en vivo
Use SSE como una señal de invalidación, luego obtenga el registro completo de REST.
Ruta 5
Construir un modelo macro
Convierta un pequeño grupo de indicadores relacionados en una tarjeta de puntuación de moneda etiquetada por fuente.
Su prueba de API de 14 días
Pase de la primera solicitud a un trabajo que valga la pena conservar.
El objetivo no es visitar cada página de producto. Es completar un trabajo útil autenticado de API, regresar otro día y salir con un conjunto de datos repetible o un flujo de trabajo de aplicación.
Días 1-2
Haga que la solicitud sea confiable
Resuelva problemas de autenticación o de filtrado y convierta el primer script en un trabajo con nombre repetible.
Abrir paso →Días 3-4
Añadir momento de publicación
Use el calendario como una segunda familia de endpoints y programe la próxima ejecución útil de API.
Abrir paso →Días 5-7
Construir el resultado de la investigación
Agregue expectativas o un grupo pequeño de series macro, luego produzca una comparación, tabla o tarjeta de puntuación guardada.
Abrir paso →Días 8-10
Automatice actualizaciones
Elija REST, SSE o webhooks programados y complete otra ejecución exitosa de API en un día diferente.
Abrir paso →Días 11-13
Refuerce el cliente
Agregue tiempos de espera, reintentos limitados, validación de respuestas, registro seguro de credenciales y monitoreo de datos obsoletos.
Abrir paso →Día 14
Revisar evidencia
Confirme que el API proporciona un trabajo repetible que su equipo mantendrá, luego elija el siguiente conjunto de datos o flujo de trabajo de aplicación.
Abrir paso →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.
Ejemplo funcional
Mantenga su clave en FXMD_API_KEY; nunca lo pegue en el control de código fuente.
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])Resultado esperado: Recent EUR inflation release groups with source-labelled forecasts that were recorded before each announcement.
Cuando el primer script se convierte en un sistema real
Resolución de problemas y guía de producción
Utilice estas guías cuando una respuesta falle, no devuelva datos o necesite controles de producción como caché, tiempos de espera, reintentos y entrega de eventos.
| Guía | Úselo cuando | Comenzar |
|---|---|---|
| Diagnosticar una respuesta fallida o vacía | Separe los problemas de autenticación, acceso, ruta, límite de tasa y disponibilidad de datos sin exponer su clave. | Abrir guía → |
| Hacer que un cliente API esté listo para producción | Añada tiempos de espera, reintentos limitados, almacenamiento en caché, solicitudes condicionales y el patrón de entrega adecuado. | Abrir guía → |