Diwrnod 0
Dangos mynediad
Crëwch y allwedd, cwbliwch un cais wedi'i dilysu, a storrwch yr ymateb cyntaf gyda'i metaddata.
Agor cam →canllaw llifoedd gweithredol API
Beth rydych chi eisiau ei adeiladu?
Dewiswch yr canlyniad mwyaf agos at eich swydd. Mae pob llwybr yn rhoi un cais gweithredol i chi, beth ydych chi'n ei angen i'r ymateb gael ei gynnwys, sut i wirio ei fod wedi gweithio, a'r cam defnyddiol nesaf.
Pump llwybr ymarferol
Dechreuwch gyda'r canlyniad, nid y rhestr pontwedd.
Selected: Troubleshoot a request
Llwybr 1
Ffeindio data macro
Dangoswch gyflwr amser glân a chadwesoch y metaddata ffynhonnell a chwalfedrwydd wrth ei gyd.
Llwybr 2
Cynllunio swyddi cyhoeddi
Defnyddiwch y calendriu cyfnod i redeg jobiau targedol o amgylch amseroedd cyhoeddi sy'n hysbys.
Llwybr 3
Mesura syndodiadau
Ynuno rhagolygon cyn-gyhoeddi â'r gwerth cyhoeddedig heb gyflwyno bias edrych ymlaen.
Llwybr 4
Derbynwch uweldau byw
Defnyddiwch SSE fel arwydd invalidation, yna fynychwch y record llawn o REST.
Llwybr 5
Adeiladu model macro
Trodd grŵp bach o indicatoria perthnasol yn sgôrcard cyfrifiodd wedi'i labelu gan ffynhonnell.
Eich profiad API 14 diwrnod
Symud o ofbynion cyntaf i waith werthus i'w gadw.
Nid yw'r nod yn ymwideo â phob dudalen cynnyrch. Mae'n ymwideo â chwblhau gwaith API wedi dilysu defnyddiol, dychwelyd ar ddiwrnod arall, a gadael gyda dataset neu llifoedd gweithredol ailadroddwyol.
Diwrnodiau 1-2
Gwneud y cais dibynadwy
Datrys problemau dilysu neu hidlo a troi'r sgript cyntaf yn job enwog ailadroddwyol.
Agor cam →Diwrnodau 3-4
Ychwanegu amser allalad
Defnyddiwch y calendr fel teulu pontwedd arall ac amgylcheddio'r rhedeg API defnyddiol nesaf.
Agor cam →Diwrnodiau 5-7
Adeiladu'r canlyniad ymchwil
Ychwanegwch rhagwyliadau neu grŵp bach o gyfres macro, yna cynhyrchwch un gymharliad, tabl, neu sgorecard wedi'i storio.
Agor cam →Diwrnodau 8-10
Automate diweddariadau
Dewiswch REST, SSE, neu webhooks wedi'u trefnu a chwblhau rhedeg API llwyddiannus ar ddiwrnod gwahanol.
Agor cam →Diwrnodau 11-13
Gadarnhau'r cleient
Ychwanegwch amweiltiau, admelodaethau cyfyngedig, dilysu'r ymateb, logio diogel i mewn i credydau, a monitoriad data hen.
Agor cam →Diwrnod 14
Adolygu tystiolaeth
Cadarnhawch fod API yn darparu gwaith ailadroddus y bydd eich tîm yn ei gadw, yna dewiswch y set o ddata neu weithdrefn cael y nesaf.
Agor cam →Request help
Diagnosio ymateb wedi methu neu wag
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.
Enghraifft weithredol
Cadwch eich allwedd yn FXMD_API_KEY; peidiwch byth â'i gludo i reolaeth ffynhonnell.
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])Canlyniad disgyledol: 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.
Pan fydd y sgript cyntaf yn system real
Troubleshooting a chyfarwyddyd cynnyrch
Defnyddiwch ycanllwydion hyn pan fydd ymateb yn methu, yn dychwelyd dim data, neu angen rheolaethau cynnyrch fel caching, amserau allu, ailadrodd, ac arbeddigedd digwyddiadau.
| Canllaw | Defnyddiwch ef pan... | Dechreuwch |
|---|---|---|
| Diagnosio ymateb wedi methu neu wag | Datblygu problemau dilysu, mynediad, llwybr, cyfyngiad rheolaidd, a swyddogoldeb data heb ei wneud yn amlwg eich allwedd. | Agor canllaw → |
| Gwneud cleient API yn barod ar gyfer cynnyrch | Ychwanegu amserau wedi gorffen, adroddiadau cyfyngedig, caddu, geisiadau amodol, a'r patrwm cyflenwi cywir. | Agor canllaw → |