Giorno 0
Dimostra l'accesso
Crea la chiave, completa una richiesta autenticata e salva la prima risposta con i suoi metadati.
Apri passaggio →guida al flusso di lavoro API
Cosa vuoi costruire?
Scegli il risultato più vicino al tuo lavoro. Ogni percorso ti fornisce una richiesta funzionante, cosa dovrebbe contenere la risposta, come verificare che abbia funzionato e il passo utile successivo.
Cinque percorsi pratici
Inizia dal risultato, non dall'elenco degli endpoint.
Selected: Harden a client
Percorso 1
Recupera dati macro
Recupera una serie storica pulita e conserva i metadati relativi alla fonte e alla qualità accanto ad essa.
Percorso 2
Pianifica i job di rilascio
Usa il calendario dei rilasci per eseguire job mirati intorno agli orari di pubblicazione noti.
Percorso 3
Misura le sorprese
Unisci le previsioni pre-rilascio al valore pubblicato senza introdurre lookahead bias.
Percorso 4
Ricevi aggiornamenti live
Usa SSE come segnale di invalidazione, quindi recupera il record completo da REST.
Percorso 5
Costruisci un modello macro
Trasforma un piccolo gruppo di indicatori correlati in un scorecard valutario etichettato per fonte.
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.
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 →Production readiness
Rendi un client API pronto per la produzione
Production reliability comes from treating status codes differently, keeping retries bounded, reusing ETags, and choosing scheduled REST, SSE, or webhooks for the job.
Esempio funzionante
Mantieni la tua chiave in FXMD_API_KEY; non incollarlo mai nel controllo sorgente.
import os
import requests
from urllib3.util.retry import Retry
session = requests.Session()
retry = Retry(total=3, backoff_factor=0.5, status_forcelist=(429, 502, 503, 504))
session.mount("https://", requests.adapters.HTTPAdapter(max_retries=retry))
response = session.get(
"https://api.fxmacrodata.com/v1/announcements/eur/inflation",
params={"api_key": os.environ["FXMD_API_KEY"], "limit": 5},
headers={"Accept-Encoding": "gzip"},
timeout=(3.05, 20),
)
response.raise_for_status()Risultato atteso: A bounded client that handles transient failures without retry storms and is ready to add ETag-based conditional refreshes.
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.
| Guida | Usalo quando | Inizia |
|---|---|---|
| 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 → |