Dan 0
Dokazati pristup
Kreirajte ključ, izvršite jedan autentificirani zahtjev i spremite prvi odgovor s njegovim metapodacima.
Otvori korak →vodič za API radni proces
Što želite izgraditi?
Odaberite ishod najbliži vašem poslu. Svaka staza daje vam jedan funkcionalni zahtjev, što odgovor treba sadržavati, kako provjeriti je li uspio i sljedeći koristan korak.
Pet praktičnih putova
Počnite s ishodom, a ne s popisom endpointa.
Selected: Troubleshoot a request
Put 1
Dohvati makro podatke
Preuzmite čistu vremensku seriju i zadržite izvorne metapodatke i metapodatke o kvaliteti pored nje.
Putanja 2
Planiraj poslove objava
Koristite kalendar izdanja za pokretanje ciljanih poslova oko poznatih vremena objavljivanja.
Staza 3
Mjerenje iznenađenja
Pridružite prognoze prije izdanja objavljenoj vrijednosti bez uvođenja pristranosti gledanja unaprijed (lookahead bias).
Put 4
Primajte live ažuriranja
Koristite SSE kao signal za invalidaciju, a zatim dohvatite cjeloviti zapis iz REST.
Putanja 5
Izgradite makro model
Pretvorite malu skupinu povezanih indikatora u scorecard valute s označenim izvorom.
Vaše 14-dnevno API probno razdoblje
Pređite s prvog zahtjeva na posao vrijedan održavanja.
Cilj nije posjetiti svaku stranicu proizvoda. Cilj je dovršiti koristan autentificirani API rad, vratiti se drugog dana i otići s ponovljivim skupom podataka ili radnim tijekom aplikacije.
Dana 1-2
Učinite zahtjev pouzdanim
Riješite probleme s autentifikacijom ili filtriranjem i pretvorite prvi skript u nazvani ponavljajući posao.
Otvori korak →Dani 3-4
Dodaj vrijeme objave
Koristite kalendar kao drugu obitelj endpointa i zakružite sljedeće korisno API pokretanje.
Otvori korak →Dana 5-7
Izgradite istraživački ishod
Dodajte očekivanja ili malu grupu makro serija, a zatim generirajte jednu spremljenu usporedbu, tablicu ili scorecard.
Otvori korak →Dana 8-10
Automatizirajte ažuriranja
Odaberite zakazane REST, SSE ili webhookove i dovršite još jedan uspješan API ciklus drugog dana.
Otvori korak →Dana 11-13
Ojačajte klijenta
Dodajte timeoutove, ograničene ponovne pokušaje, validaciju odgovora, sigurno logiranje vjerodajnica i praćenje zastarjelih podataka.
Otvori korak →Dan 14
Pregledajte dokaze
Potvrdite da API osigurava ponovljiv posao koji će vaš tim održavati, a zatim odaberite sljedeći skup podataka ili radni proces aplikacije.
Otvori korak →Request help
Dijagnosticirajte neuspjeli ili prazan odgovor
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.
Radni primjer
Držite svoj ključ u FXMD_API_KEY; nikada ga ne zalijepljite u kontrolu izvora.
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])Očekivani rezultat: 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.
Kada prvi skript postane stvarni sustav
Rješavanje problema i smjernice za produkciju
Koristite ove vodiče kada odgovor ne uspije, ne vraća podatke ili zahtijeva produkcijske kontrole kao što su predmemorija, timeouti, ponovni pokušaji i isporuka događaja.
| Vodič | Koristite ga kada | Započni |
|---|---|---|
| Dijagnosticirajte neuspjeli ili prazan odgovor | Razdvojite probleme s autentifikacijom, pristupom, putanjom, ograničenjem brzine i dostupnošću podataka bez izlaganja vašeg ključa. | Otvori vodič → |
| Učinite API klijenta spremnim za produkciju | Dodajte timeoutove, ograničene ponovljene pokušaje, cacheiranje, uvjetne zahtjeve i ispravan obrazac isporuke. | Otvori vodič → |