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: Receive live updates
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 →Real-time workflow
Receive release updates
A long-lived event stream can notify your application when matching macro data changes. The event is the trigger; the announcements endpoint remains the source for the full response.
Radni primjer
Držite svoj ključ u FXMD_API_KEY; nikada ga ne zalijepljite u kontrolu izvora.
curl -N --get \
"https://api.fxmacrodata.com/v1/stream/events" \
--data-urlencode "currencies=eur" \
--data-urlencode "indicators=inflation" \
--data-urlencode "api_key=$FXMD_API_KEY"Očekivani rezultat: A persistent filtered stream. When an event arrives, your worker fetches the related announcements endpoint and updates its local cache.
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č → |