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.
Seleccionado: Buscar macro datos
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 →Primeira requisição
Obter e gardar o historial macro
Comeza cunha moeda e un indicador que xa comprendas. Isto facilita a verificación da autenticación, a forma da resposta, a paginación e o almacenamento antes de engadir máis series.
Exemplo de funcionamento
Gardar a súa clave en FXMD_API_KEY; nunca o pegues no control de fontes.
import os
import requests
response = requests.get(
"https://api.fxmacrodata.com/v1/announcements/eur/inflation",
params={"api_key": os.environ["FXMD_API_KEY"], "limit": 5},
timeout=20,
)
response.raise_for_status()
payload = response.json()
print(payload["data"][0])Resultado esperado: Unha resposta de 200 con observacións de inflación de EUR recentes máis metadatos da resposta que describen a serie, a fonte, a paginación e a calidade dos datos.
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 → |