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: Receive live updates
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 →Real-time workflow
Receive release updates
A long-lived event stream can notify your application when matching macro data changes. The event is the trigger; the announcements endpoint remains the source for the full response.
Exemplo de funcionamento
Gardar a súa clave en FXMD_API_KEY; nunca o pegues no control de fontes.
curl -N --get \
"https://api.fxmacrodata.com/v1/stream/events" \
--data-urlencode "currencies=eur" \
--data-urlencode "indicators=inflation" \
--data-urlencode "api_key=$FXMD_API_KEY"Resultado esperado: A persistent filtered stream. When an event arrives, your worker fetches the related announcements endpoint and updates its local cache.
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 → |