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: Harden a client
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 →Production readiness
Hacer que un cliente API esté listo para producción
Production reliability comes from treating status codes differently, keeping retries bounded, reusing ETags, and choosing scheduled REST, SSE, or webhooks for the job.
Ejemplo funcional
Mantenga su clave en FXMD_API_KEY; nunca lo pegue en el control de código fuente.
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={"api_key": os.environ["FXMD_API_KEY"], "limit": 5},
headers={"Accept-Encoding": "gzip"},
timeout=(3.05, 20),
)
response.raise_for_status()Resultado esperado: A bounded client that handles transient failures without retry storms and is ready to add ETag-based conditional refreshes.
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 → |