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.
Selected: Troubleshoot a request
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 →Request help
Diagnostiko një përgjigje të dështuar ose bosh
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.
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
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])Rezultati i pritshëm: 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.
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 → |