Día 0
Probar acceso
Crea a chave, completa unha requisição autenticada e garda a primeira resposta coa súa metadatos.
Abrir paso →Guía de fluxo de traballo API
Que queres construír?
Elixe o resultado máis próximo ao teu traballo. Cada ruta dache unha solicitude de traballo, o que debe conter a resposta, como comprobar que funcionou e o próximo paso útil.
Cinco rutas prácticas
Comeza co resultado, non coa lista de endpoints.
Selected: Measure surprises
Ruta 1
Obter datos macro
Recupera unha serie temporal limpa e mantén a metadata da fonte e da calidade ao seu lado.
Ruta 2
Planificar traballos de publicación
Usa o calendario de publicación para executar traballos dirigidos en torno aos tempos de publicación coñecidos.
Ruta 3
Medir sorpresas
Xunte previsións de antes da publicación ao valor publicado sen introducir o sesgo de anticipación.
Ruta 4
Recibir actualizacións en vivo
Use SSE como unha sinal de invalidación, despois busque o rexistro completo de REST.
Ruta 5
Construír un modelo macro
Convértea un pequeno grupo de indicadores relacionados nunha tarxeta de puntuación de moeda etiquetada por fonte.
A súa proba de API de 14 días
Pasa da primeira solicitude a un traballo que merece a pena manter.
O obxectivo non é visitar cada páxina de produto. É completar un traballo útil autenticado de API, volver noutro día e marchar cun conxunto de datos repetible ou un fluxo de traballo de aplicación.
Días 1-2
Facer a petición dependíble
Resolva problemas de autenticación ou de filtro e converta o primeiro script nun xogo nomeado e repetible.
Abrir paso →Días 3-4
Añadir tempo de publicación
Use o calendario como unha segunda familia de endpoints e programe a próxima execución útil de API.
Abrir paso →Días 5-7
Construír o resultado da investigación
Engade expectativas ou un pequeno grupo de series macro, e despois xera unha comparación, táboa ou scorecard gardada.
Abrir paso →Días 8-10
Automatizar actualizacións
Elixe REST, SSE programados ou webhooks e completa outra execución exitosa de API nun día diferente.
Abrir paso →Días 11-13
Reforzar o cliente
Engade tempos de espera, reintentos limitados, validación de resposta, rexistro seguro de credenciais e monitorización de datos caducos.
Abrir paso →Día 14
Revisar evidencia
Confirma que o API proporciona un traballo repetible que o teu equipo manterá, e despois elixe o próximo conxunto de datos ou fluxo de traballo 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.
Exemplo de funcionamento
Gardar a súa clave en FXMD_API_KEY; nunca o pegues no control de fontes.
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.
Cando o primeiro script se converte nun sistema real
Resolución de problemas e guía de produción
Usa estas guías cando unha resposta falla, non devolve datos ou precisa controles de produción como caché, tempos de espera, reintentos e entrega de eventos.
| Guía | Úsao cando | Comezar |
|---|---|---|
| Diagnosticar unha resposta fallida ou vacía | Separe os problemas de autenticación, acceso, ruta, límite de taxa e dispoñibilidade de datos sen expor a súa clave. | Abrir guía → |
| Facer un cliente de API listo para produción | Añada tempos de espera, reintentos limitados, caché, solicitudes condicionais e o patrón de entrega correcto. | Abrir guía → |