Salta al contenuto

guida al flusso di lavoro API

Cosa vuoi costruire?

Inizia con un workflow di ricerca e un foglio di calcolo, o segui una guida API per costruire la tua applicazione.

Choose your next step

Put macro data to work.

Inizia con un flusso di lavoro di ricerca

Scegli un punto di partenza, esamina le evidenze e tieni un quaderno di lavoro che puoi ricostruire.

Accesso Starter · macro USD

Monitor dell'inflazione

Monitora l'inflazione headline e core di US insieme a EUR/USD.

Apri il flusso di lavoro
Abbonamento richiesto

Confronto delle politiche delle banche centrali

Confronta i tassi di politica monetaria di US e dell'area euro insieme a EUR/USD.

Apri il flusso di lavoro
Abbonamento richiesto

Revisione di rilascio e revisione

Ispeziona i rilascio, i valori e le prove di pubblicazione dell'inflazione US conservati.

Apri il flusso di lavoro

Verifica la copertura prima di scegliere un piano. Usi già un'integrazione con foglio di calcolo? Segui il Guida Excel o Guida di Google Sheets per le funzioni supportate e il comportamento di aggiornamento.

Valutare il API? Ispeziona il campione limitato per sviluppatori storici e i suoi campi di risposta.

Cinque percorsi pratici

Inizia dal risultato, non dall'elenco degli endpoint.

Selezionato: Recupera dati macro

La tua prova API di 14 giorni

Passa dalla prima richiesta a un lavoro che valga la pena di essere mantenuto.

L'obiettivo non è visitare ogni pagina prodotto. È completare un lavoro autenticato API utile, tornare in un altro giorno e uscire con un set di dati o un workflow di applicazione ripetibile.

Controlla progressi API

Giorno 0

Dimostra l'accesso

Crea la chiave, completa una richiesta autenticata e salva la prima risposta con i suoi metadati.

Apri passaggio →

Giorni 1-2

Rendi la richiesta affidabile

Risolvi problemi di autenticazione o filtri e trasforma il primo script in un job ripetibile nominato.

Apri passaggio →

Giorni 3-4

Aggiungi tempistica di rilascio

Usa il calendario come seconda famiglia di endpoint e programma la prossima esecuzione utile di API.

Apri passaggio →

Giorni 5-7

Costruisci l'output della ricerca

Aggiungi aspettative o un piccolo gruppo di serie macro, quindi produci un confronto, una tabella o un punteggio salvato.

Apri passaggio →

Giorni 8-10

Automatizza aggiornamenti

Scegli REST, SSE o webhook pianificati e completa un altro esecuzione API con successo in un giorno diverso.

Apri passaggio →

Giorni 11-13

Rafforza il client

Aggiungi timeout, tentativi limitati, validazione della risposta, logging sicuro per le credenziali e monitoraggio dei dati obsoleti.

Apri passaggio →

Giorno 14

Esamina le prove

Conferma che API fornisca un lavoro ripetibile che il tuo team manterrà, quindi scegli il prossimo dataset o workflow applicativo.

Apri passaggio →

Prima richiesta

Recupera e salva la cronologia macro

Inizia con una valuta e un indicatore che già comprendi. Questo rende facile verificare l'autenticazione, la forma della risposta, la paginazione e l'archiviazione prima di aggiungere altre serie.

minuti 10 Inizia qui annunci

Esempio funzionante

Mantieni la tua chiave in FXMD_API_KEY; non incollarlo mai nel controllo sorgente.

import os
import requests

response = requests.get(
    "https://api.fxmacrodata.com/v1/announcements/eur/inflation",
    params={"limit": 5},
    headers={"X-API-Key": os.environ["FXMD_API_KEY"]},
    timeout=20,
)
response.raise_for_status()
payload = response.json()
print(payload["data"][0])

Risultato atteso: Una risposta 200 con recenti osservazioni sull'inflazione EUR più i metadati della risposta che descrivono la serie, la sorgente, la paginazione e la qualità dei dati.

Quando il primo script diventa un sistema reale

Risoluzione dei problemi e guida alla produzione

Utilizza queste guide quando una risposta fallisce, non restituisce dati o necessita di controlli di produzione come caching, timeout, tentativi di ripristino e consegna degli eventi.

GuidaUsalo quandoInizia
Diagnostica di una risposta fallita o vuota Separa i problemi di autenticazione, accesso, percorso, limite di frequenza e disponibilità dei dati senza esporre la tua chiave. Apri guida →
Rendi un client API pronto per la produzione Aggiungi timeout, tentativi limitati, caching, richieste condizionali e il corretto pattern di consegna. Apri guida →