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: Troubleshoot a request
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 →Request help
Diagnosticar unha resposta fallida ou vacía
Inspect the status and a short error body, then follow the matching fix. Never paste an API key or a full authenticated URL into a support message.
Exemplo de funcionamento
Gardar a súa clave en FXMD_API_KEY; nunca o pegues no control de fontes.
import os
import requests
key = os.getenv("FXMD_API_KEY", "").strip()
if not key:
raise RuntimeError("FXMD_API_KEY is not set")
response = requests.get(
"https://api.fxmacrodata.com/v1/announcements/eur/inflation",
params={"api_key": key, "limit": 1},
timeout=20,
)
print(response.status_code, response.text[:300])Resultado esperado: A 200 confirms the key and path work. A 401 or 403 points to authentication or access, a 404 to the path, and a 429 to request pacing.
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 → |