Usuku 0
Qinisekisa ukufinyelela
Dala i-key, uqedele isicelo esiqinisekisiwe esisodwa, bese ugcina impendulo yokuqala kanye nemetadata yayo.
Vula isinyathelo →isikhumbuzo sendlela yokusebenza ye-API
Ufuna ukwakha ini?
Khetha umphumela osondelene nomsebenzi wakho. Isizinda ngasinye sikunikeza isicelo esisodwa esisebenzayo, okufanele kube khona kumphendulo, ukuthi ungenza kanjani ukuhlola ukuthi kusebenze, nesinyathelo esilandelayo esibalulekile.
Izindlela ezinhlanu eziyingqayizivele
Qala ngomphumela, hhayi uhlu lwe-endpoint.
Okukhethiwe: Thola idatha ye-macro
Indlela 1
Landa idatha yemakro
Thola i-time series ehlanzekile futhi ugcine imininingwane yomthombo kanye nekhwalithi eduze kwayo.
Indlela ye-2
Hlela imisebenzi yokukhishwa
Sebenzisa ikalenda yokukhishwa ukuze uqhube imisebenzi ethile ngamaxesha okukhiphwa aziwayo.
Indlela (Path) ye-3
Linganisa ukumangala (surprises)
Xhumanisa izibikezelo zangaphambi kokukhishwa nenani elikade likhishwe ngaphandle kokufaka ubuqili bokubona okuzokwenzeka (lookahead bias).
Indlela 4
Thola izibuyekezo eziphila (live)
Sebenzisa i-SSE njengesibonakaliso sokungasebenzi, bese ulandela i-record ephelele ku-REST.
Indlela 5
Yakha i-macro model
Guqula iqembu elincane lezindikator ezihlobene libe yi-scorecard yezimali enomhlabelo womthombo.
Ukuhlola kwakho kwama-14 izinsuku kwe-API
Suka kokuqala isicelo uya emsebenzini ofanele ukugcinwa.
Inhloso akukhona ukuvakashela yonke ikhasi lempahla. Inhloso wukwenza umsebenzi obalulekile we-API obunokuhlunyelelwa, uphinde ubuye ngolunye usuku, uphume unomsebenzi wedatha noma i-workflow yohlelo olungaphindelekayo.
Izinsuku 1-2
Yenza i-request ibe nokuphikelela
Xazulula izinkinga zokuhlunyelelwa noma zama-filter bese uwenze isikripthi sokuqala sibe umsebenzi ogamelekile onamagama.
Vula isinyathelo →Izinsuku 3-4
Faka isikhathi sokukhishwa
Sebenzisa ikhalenda njengohlobo lwe-endpoint yesibili bese uhlela ukugijima kwe-API okusebenzayo okulandelayo.
Vula isinyathelo →Izinsuku ze-5-7
Yakha umphumela wocwaningo
Faka izithemba noma iqembu elincane le-macro series, bese ukhiqiza ukulinganiso, ithebula, noma isikweletimandla esilodwa esigcinwe.
Vula isinyathelo →Izinsuku ze-8-10
Zenzela ngokuzenzakalelayo ukubuyekeza
Khetha i-REST ehleliwe, i-SSE, noma ama-webhooks bese uqedela okunye ukugijima kwe-API okusebenza ngosuku oluhlukile.
Vula isinyathelo →Izinsuku 11-13
Qinisa iklayenti
Faka ama-timeout, ama-bounded retries, ukuqinisekiswa kwemphendulo, i-credential-safe logging, kanye nokubhekwa kwemininingwane endala.
Vula isinyathelo →Usuku lwe-14
Bheka ubufakazi
Qinisekisa ukuthi i-API inikeza umsebenzi ongaphindwawe ithimba lakho lizogcina, bese ukhetha idatha elandelayo noma umsebenzi we-application.
Vula isinyathelo →Isicelo sokuqala
Faka futhi ugcine imlanduko ye-macro
Qala nge-currency kanye ne-indicator oyaziyo kakade. Lokhu kwenza ukuhlunyeleliswa, isimo sempendulo, i-pagination, kanye nokugcinwa kube lula ukukuhlola ngaphambi kokuba ufake ezinye izinhlobo.
Isibonelo esisebenzayo
Gcina i-key yakho ku FXMD_API_KEY; ungakaze uyifake ku-source control.
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])Umphumela olindelekile: Imphendulo ka-200 enokubona kwe-inflation ka-EUR okusanda kudlula kanye nemetadata yempendulo echaza i-series, umthombo, i-pagination, kanye nekhwalithi yedatha.
Lapho isikripthi sokuqala siba yisistimu yangempela
Ukuxazulula izinkinga nokuqondiswa kwe-production
Sebenzisa lezi zihlobo lapho impendulo ihluleka, ingabulethe imininingwane, noma idinga ukulawulwa kwe-production njengokugcina (caching), ukulinda (timeouts), ukuzama kabusha, nokuhlinzekwa kwezehlakalo.
| Umhlahlandlela | Yisebenzise uma | Qala |
|---|---|---|
| Hlaziya impendulo ehlulekile noma engenalutho | Izinkingo ezihlukene zokuhlunyelelwa, ukufinyelela, indlela, imikhawulo yemikhuba, nokutholakala kwedatha ngaphandle kokukhombisa i-key yakho. | Vula umhlahlandlela → |
| Yenza i-client ye-API ilungele ukukhiqizwa | Faka ama-timeout, ukuzama kabusha okuncishisiwe, i-caching, izicelo eziyisimo, kanye nendlela yokulethwa efanele. | Vula umhlahlandlela → |