Zi 0
Dovedește accesul
Creați cheia, efectuați o singură cerere autentificată și salvați primul răspuns împreună cu metadatele sale.
Deschide pasul →ghid de flux de lucru API
Ce doriți să construiți?
Alege rezultatul cel mai apropiat de activitatea ta. Fiecare cale îți oferă o cerere funcțională, ceea ce ar trebui să conțină răspunsul, cum să verifici dacă a funcționat și următorul pas util.
Cinci căi practice
Începeți cu rezultatul, nu cu lista de endpoint-uri.
Selectat: Preluare date macro
Cale 1
Preluați date macro
Obțineți o serie temporală curată și păstrați metadatele de sursă și calitate alături de aceasta.
Cale 2
Planificați joburile de publicare
Folosește calendarul de release pentru a rula joburi targetate în jurul timpilor de publicare cunoscute.
Cale 3
Măsoară surprizele
Unește previziunile de pre-release cu valoarea publicată fără a introduce bias de lookahead.
Cale 4
Primește actualizări live
Utilizați SSE ca semnal de invalidare, apoi preluați înregistrarea completă de la REST.
Cale 5
Construiește un model macro
Transformați un grup mic de indicatori relaționați într-un tabel de scor pe valută etichetat cu sursa.
Perioada ta de probă API de 14 zile
Treceți de la prima cerere la un job meritând păstrat.
Scopul nu este de a vizita fiecare pagină de produs. Este de a finaliza o lucrare API autentificată utilă, de a reveni în altă zi și de a pleca cu un set de date sau un flux de lucru al aplicației repetabil.
Zile 1-2
Faceți cererea fiabilă
Rezolvă problemele de autentificare sau filtrare și transformă primul script într-un job repetabil numit.
Deschide pasul →Zile 3-4
Adaugă momentul publicării
Utilizați calendarul ca o a doua familie de endpoint-uri și programați următoarea rulare utilă API.
Deschide pasul →Zile 5-7
Construiește rezultatul cercetării
Adaugă așteptări sau un grup mic de serii macro, apoi produce o singură comparație salvată, tabel sau scorecard.
Deschide pasul →Zile 8-10
Automatizați actualizările
Alege REST, SSE programate sau webhooks și finalizează o altă rulare API reușită într-o altă zi.
Deschide pasul →Zile 11-13
Consolidați clientul
Adaugă timeout-uri, reîncercări limitate, validarea răspunsului, jurnalizare sigură a credențialelor și monitorizarea datelor învechite.
Deschide pasul →Ziua 14
Revizuiește probele
Confirmați că API furnizează un job repetabil pe care echipa dvs. îl va păstra, apoi alegeți următorul set de date sau flux de lucru al aplicației.
Deschide pasul →Prima cerere
Preia și salvează istoricul macro
Începe cu o monedă și un indicator pe care deja îi înțelegi. Acest lucru face ca autentificarea, forma răspunsului, paginarea și stocarea să fie ușor de verificat înainte de a adăuga mai multe serii.
Exemplu funcțional
Păstrați cheia în FXMD_API_KEY; nu o lipi niciodată în controlul surselor.
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])Rezultat așteptat: Un răspuns 200 cu observații recente privind inflația EUR, plus metadate de răspuns care descriu seria, sursa, paginarea și calitatea datelor.
Când primul script devine un sistem real
Depanare și ghidare de producție
Utilizați aceste ghiduri atunci când un răspuns eșuează, nu returnează date sau necesită controale de producție precum cache-ul, timeout-urile, reîncercările și livrarea de evenimente.
| Ghid | Utilizați-l când | Start |
|---|---|---|
| Diagnostichează un răspuns eșuat sau gol | Separă problemele de autentificare, acces, cale, limită de rată și disponibilitatea datelor fără a expune cheia. | Deschide ghidul → |
| Faceți un client API gata de producție | Adaugă timeout-uri, reîncercări limitate, caching, cereri condiționate și modelul de livrare corect. | Deschide ghidul → |