Dita 0
Dëshmo aksesin
Krijoni çelësin, përfundoni një kërkesë të autentikuar dhe ruani përgjigjen e parë me metadata e saj.
Hapni hapin →udhëzues i procesit të punës API
Çfarë dëshironi të ndërtoni?
Zgjidhni rezultatin më të afërt me punën tuaj. Çdo rrugë ju jep një kërkesë pune, çfarë duhet të përmbajë përgjigja, si të kontrolloni nëse funksionoi, dhe hapin e radhës të dobishëm.
Pesë rrugë praktike
Filloni me rezultatin, jo me listën e endpoint-eve.
E selektuar: Shkarko të dhëna makro
Rruga 1
Tërhiqni të dhëna makro
Tërhiqni një seri kohore të pastër dhe mbani metadata të burimit dhe cilësisë pranë saj.
Rruga 2
Planifikoni punët e publikimit
Përdorni kalendarin e lançimit për të ekzekutuar punë të synuara rreth kohëve të njohura të publikimit.
Rruga 3
Matet surprizat
Bashko parashikimet para-lanzimit me vlerën e publikuar pa prezantuar një anashkalim të parashikimit (lookahead bias).
Rruga 4
Merrni përditësime live
Përdorni SSE si një sinjal invalidimi, pastaj merrni regjistrin e plotë nga REST.
Rruga 5
Ndërto një model makro
Shndërroni një grup të vogël indikatorësh të lidhur në një scorecard valutare të etiketuar me burim.
Provën tuaj API prej 14 ditësh
Kaloni nga kërkesa e parë në një punë që ia vlen të mbahet.
Qëllimi nuk është të vizitoni çdo faqe produkti. Është të përfundoni punë të dobishme të autentikuara API, të ktheheni në një ditë tjetër, dhe të largoheni me një dataset ose workflow aplikacioni të përsëritshëm.
Ditë 1-2
Bëjeni kërkesën të besueshme
Zgjidhni problemet e autentikimit ose filtrimit dhe ktheni skriptin e parë në një punë të emërtuar dhe të përsëritshme.
Hapni hapin →Ditët 3-4
Shto kohën e lëshimit
Përdorni kalendarin si një familje të dytë endpoint-esh dhe planifikoni ekzekutimin e radhës të dobishëm të API.
Hapni hapin →Ditët 5-7
Ndërtoni rezultatin e kërkimit
Shtoni pritshmëritë ose një grup të vogël serish makro, pastaj prodhoni një krahasim, tabelë ose scorecard të ruajtur.
Hapni hapin →Ditët 8-10
Automatizoni përditësimet
Zgjidhni REST, SSE, ose webhooks të planifikuar dhe përfundoni një API tjetër të suksesshëm në një ditë tjetër.
Hapni hapin →Ditët 11-13
Forconi klientin
Shtoni timeouts, rishikime të kufizuara, validim të përgjigjes, regjistrim të sigurt të kredencialeve dhe monitorim të të dhënave të vjetruara.
Hapni hapin →Dita 14
Rishiko dëshmitë
Konfirmoni që API siguron një punë të përsëritshme që ekipi juaj do ta mbajë, pastaj zgjidhni dataset-in ose workflow-in e aplikacionit tjetër.
Hapni hapin →Kërkesa e parë
Shtirr dhe ruaj historinë makro
Filloni me një monedhë dhe indikator që e kuptoni tashmë. Kjo e bën autentikimin, formën e përgjigjes, faqen (pagination) dhe ruajtjen të lehtë për t'u verifikuar përpara se të shtoni më shumë seri.
Shembull pune
Mbajeni çelësin tuaj në FXMD_API_KEY; kurrë mos e ngjisni atë në kontrollin e burimit (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])Rezultati i pritshëm: Një përgjigje 200 me vëzhgimet e fundit të inflacionit EUR plus metadata të përgjigjes që përshkruan serinë, burimin, faqinimin dhe cilësinë e të dhënave.
Kur skripti i parë bëhet një sistem real
Zgjidhja e problemeve dhe udhëzime për prodhimin
Përdorni këto udhëzues kur një përgjigje dështon, nuk kthen asnjë të dhënë, ose ka nevojë për kontrole prodhimi si caching, timeouts, retries dhe dërgimin e eventeve.
| Udhëzues | Përdorehet kur | Fillo |
|---|---|---|
| Diagnostiko një përgjigje të dështuar ose bosh | Probleme të ndara të autentikimit, aksesit, rrugës, limitit të shpejtësisë dhe disponueshmërisë së të dhënave pa ekspozuar çelësin tuaj. | Hap udhëzuesin → |
| Bëni një klient API të gatshëm për prodhim | Shtoni timeouts, rishikime të kufizuara, caching, kërkesa kushtëzore dhe modelin e duhur të dërgesës. | Hap udhëzuesin → |