Ġurnata 0
Iproveża l-aċċess
Tħabbet il-key, ikkompleta reqjiet imxierna waħda, u salva r-rispons l-ewwel b'metadata tiegħu.
Iftaħ pass →gwida tal-workflow API
X'tixtieq tibni?
Agħżel l-eżitu li jkun l-aktar qrib ix-xogħol tiegħek. Kull triqqa' tagħtik tal-bidla waħda ta' talba li taħdem, x'għandu jkun fiha r-rispons, kif tiċċekkja li ħdem, u l-pass util li jmiss.
Ħames pothijiet prattiċi
Ibda bl-output, mhux mal-lista tal-endpoints.
Selected: Troubleshoot a request
Triqqa' 1
Ġib data makro
Iġbed time series nadifa u żomm il-metadata tas-sors u l-kwalità ħdejnih.
Triq 2
𝗣𝗹𝗮𝗻 rilascċi ta' jobs
Uża l-kalendarju tal-rilaxx biex tiġri jobs miri madwar il-ħinijiet ta' pubblikazzjoni magħrufa.
Triq 3
Kejja sorpriżi
Żviluppa l-previsioni ta' qabel ir-rilaxx mal-valur ippubblikat mingħajr li tuża lookahead bias.
Triqqa' 4
Irċievi updates live
Uża SSE bħala siġnal ta' invalidazzjoni, imbagħad iġbor ir-record sħiħ mill- REST.
Triq 5
Bni mudell makro
Turna grupp żgħir ta' indikaturi relatati f'scorecard tal-munita b'lblikk ta' sors.
Il-trial API ta' 14 giorni tiegħek
Movri mill-ewwel reqjiet għal xogħol li worth iżomm.
Il-mira mhix li żżur kull paġna tal-prodott. Hi li tlestina xogħol API autentikat utli, tirritorna f'ġurnata oħra, u titlaq b'dataset jew workflow ta' applikazzjoni ripetibbli.
Ġurnata 1-2
Iġbid il-request biex tkun dependable
Solvi problemi ta' autentikazzjoni jew filtru u turning l-ewwel skript f'job imsemmija u ripetibbli.
Iftaħ pass →Ġurnati 3-4
Aggiungi żmien tar-rilascċ
Uża l-kalendarju bħala familja ta' endpoint sħiħa u skedinċa l-liet API run li jkun utli.
Iftaħ pass →Jum 5-7
Bni l-output tal-riċerka
Aggiungi aspettattvi jew grupp żgħir ta' serijiet makro, imbagħad produċi komparazzjoni, tabella, jew scorecard salvata.
Iftaħ pass →Jum 8-10
Awtomatizza updates
Agħżel REST, SSE, jew webhooks skedjati u ikkompleta run API oħra suċċessiva f'jum differenti.
Iftaħ pass →Ġurnata 11-13
Iġġel il-client
Aggiungi timeouts, retries limitati, validazzjoni tar-rispons, logging sigur għall-kredenzjali, u monitoraġġ ta' data skaduta.
Iftaħ pass →Ġurnata 14
Rrevedi l-evidenza
Konferma li l-API jipprovdi xogħol ripetibbli li l-tim tiegħek se jżomm, imbagħad agħżel id-dataset jew il-fluss ta' xogħol tal-applikazzjoni li jmiss.
Iftaħ pass →Request help
Iddiagniċa risposta falluta jew vojta
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.
Eżempju ta' xogħol
Żżomm il-klavijiet tiegħek f' FXMD_API_KEY; qatt ma tiffastaha f'source control.
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])Riżultat attesi: 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.
Meta l-ewwel skript isir sistema reali
Troubleshooting u gwida ta' produzzjoni
Uża dawn it-gwida meta risposta tiflaħ, ma tħarrġix data, jew tkun għandha bżonn kontrolli ta' produzzjoni bħal caching, timeouts, riżżiet, u delivery ta' events.
| Gwida | Użah meta | Ibda |
|---|---|---|
| Iddiagniċa risposta falluta jew vojta | Problemi separati ta' autentikazzjoni, aċċess, triq, limitazzjoni tar-rate, u disponibbiltà tad-data mingħajr ma tiżvela l-klavijiet tiegħek. | Aħloḥ gwida → |
| Iġbid API client biex ikun ready għall-produzzjoni | Żid timeouts, retries limitati, caching, requests kondizzjonali, u l-pattern ta' deliveryġġettiv. | Aħloḥ gwida → |