Dan 0
Dokažite pristup
Kreirajte ključ, izvršite jedan autentifikovani zahtjev i sačuvajte prvi odgovor sa njegovim metapodacima.
Otvori korak →API vodič za radni tok
Šta želite izgraditi?
Odaberite ishod najbliži vašem poslu. Svaki put vam daje jedan radni zahtjev, šta odgovor treba sadržati, kako provjeriti da li je uspjelo i sljedeći koristan korak.
Pet praktičnih putanja
Počnite s ishodom, a ne s listom endpointa.
Odabrano: Preuzmi makro podatke
Putanja 1
Preuzmi makro podatke
Preuzmite čiste vremenske serije i zadržite metapodatke o izvoru i kvalitetu uz njih.
Putanja 2
Planiraj poslove objavljivanja
Koristite kalendar objavljivanja za pokretanje ciljanih poslova oko poznatih vremena objavljivanja.
Putanja 3
Mjeri iznenađenja
Pridružite prognoze prije objavljivanja objavljenoj vrijednosti bez uvođenja lookahead pristrasnosti.
Putanja 4
Primajte live ažuriranja
Koristite SSE kao signal za poništavanje, zatim preuzmite potpuni zapis iz REST.
Putanja 5
Izgradite makro model
Pretvorite malu grupu povezanih indikatora u tabelu valuta označenih izvorom.
Vaš 14-dnevni API probni period
Krenite od prvog zahtjeva do posla vrijednog zadržavanja.
Cilj nije posjetiti svaku stranicu proizvoda. Cilj je završiti koristan autentificirani API posao, vratiti se drugog dana i otići s ponovljivim setom podataka ili radnim tokom aplikacije.
Dani 1-2
Učinite zahtjev pouzdanim
Riješite probleme s autentifikacijom ili filtriranjem i pretvorite prvi skript u imenovani ponovljivi posao.
Otvori korak →Dani 3-4
Dodaj vrijeme objave
Koristite kalendar kao drugu porodicu endpointa i zakažite sljedeće korisno API pokretanje.
Otvori korak →Dani 5-7
Izgradite istraživački izlaz
Dodajte očekivanja ili malu grupu makro serija, zatim kreirajte jedno sačuvano poređenje, tabelu ili scorecard.
Otvori korak →Dani 8-10
Automatizujte ažuriranja
Odaberite zakazani REST, SSE ili webhook-ove i završite još jedno uspješno API pokretanje drugog dana.
Otvori korak →Dani 11-13
Ojačajte klijenta
Dodajte timeout-ove, ograničene pokušaje ponovnog slanja, validaciju odgovora, sigurno logovanje kredencijala i praćenje zastarjelih podataka.
Otvori korak →Dan 14
Pregledajte dokaze
Potvrdite da API obezbjeđuje ponovljiv posao koji će vaš tim zadržati, zatim odaberite sljedeći set podataka ili radni tok aplikacije.
Otvori korak →Prvi zahtjev
Preuzmi i sačuvaj makro historiju
Započnite sa jednom valutom i indikatorom koje već razumijete. To olakšava verifikaciju autentifikacije, oblika odgovora, paginacije i pohrane prije nego što dodate više serija.
Radni primjer
Čuvajte svoj ključ u FXMD_API_KEY; nikada ga ne lijepite u kontrolu izvora.
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])Očekivani rezultat: 200 odgovor sa nedavnim EUR zapažanjima inflacije plus metapodaci odgovora koji opisuju seriju, izvor, paginaciju i kvalitet podataka.
Kada prva skripta postane pravi sistem
Rješavanje problema i smjernice za produkciju
Koristite ove vodiče kada odgovor ne uspije, ne vrati podatke ili zahtijeva proizvodne kontrole kao što su keširanje, timeout-i, ponovni pokušaji i isporuka događaja.
| Vodič | Koristite ga kada | Start |
|---|---|---|
| Dijagnostikuj neuspjeli ili prazan odgovor | Odvojite probleme s autentifikacijom, pristupom, putanjom, ograničenjem brzine i dostupnošću podataka bez otkrivanja svog ključa. | Otvori vodič → |
| Učinite API klijenta spremnim za produkciju | Dodaj timeout-e, ograničene pokušaje ponovnog slanja, keširanje, kondicionalne zahtjeve i ispravan obrazac isporuke. | Otvori vodič → |