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: Harden a client
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 →Production readiness
Gwneud cleient API yn barod ar gyfer cynnyrch
Production reliability comes from treating status codes differently, keeping retries bounded, reusing ETags, and choosing scheduled REST, SSE, or webhooks for the job.
Enghraifft weithredol
Cadwch eich allwedd yn FXMD_API_KEY; peidiwch byth â'i gludo i reolaeth ffynhonnell.
import os
import requests
from urllib3.util.retry import Retry
session = requests.Session()
retry = Retry(total=3, backoff_factor=0.5, status_forcelist=(429, 502, 503, 504))
session.mount("https://", requests.adapters.HTTPAdapter(max_retries=retry))
response = session.get(
"https://api.fxmacrodata.com/v1/announcements/eur/inflation",
params={"api_key": os.environ["FXMD_API_KEY"], "limit": 5},
headers={"Accept-Encoding": "gzip"},
timeout=(3.05, 20),
)
response.raise_for_status()Canlyniad disgyledol: A bounded client that handles transient failures without retry storms and is ready to add ETag-based conditional refreshes.
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 → |