Deň 0
Dokázať prístup
Vytvorte kľúč, dokončite jeden autentifikovaný request a uložte prvú odpoveď s jej metadata.
Otvoriť krok →príručka k workflow API
Čo chcete vybudovať?
Vyberte výsledok najbližší vašej práci. Každá cesta vám poskytne jeden funkčný request, informáciu o tom, čo by mala odpoveď obsahovať, ako skontrolovať, či fungovala, a ďalší užitočný krok.
Päť praktických ciest
Začnite s výsledkom, nie so zoznamom endpointov.
Selected: Receive live updates
Cesta 1
Získať makro dáta
Získajte čistý časový rad a ponechajte pri ňom metadata o zdroji a kvalite.
Cesta 2
Plánovať úlohy publikovania
Použite kalendár vydaní na spustenie cielených úloh okolo známych časov publikácie.
Cesta 3
Meriať prekvapenia
Pripojte predvydaní prognózy k publikovanej hodnote bez zavedenia lookahead bias.
Cesta 4
Prijať live aktualizácie
Použite SSE ako signál neplatnosti, potom získajte celý záznam z REST.
Cesta 5
Vytvoriť makro model
Premeňte malú skupinu súvisiacich indikátorov na scorecard meny s označeným zdrojom.
Vaša 14-dňová API skúška
Prejdite od prvého requestu k práci, za ktorú stojí stáť.
Cieľom nie je navštíviť každú stránku produktu. Cieľom je dokončiť užitočnú autentifikovanú API prácu, vrátiť sa v ďalší deň a odísť s opakovateľnou sadou dát alebo pracovným postupom aplikácie.
Dni 1-2
Urobte request spoľahlivým
Vyriešte problémy s autentifikáciou alebo filtrom a premeňte prvý skript na pomenovanú opakovateľnú úlohu.
Otvoriť krok →Dni 3-4
Pridať načasovanie vydania
Použite kalendár ako druhú rodinu endpointov a naplánujte ďalší užitočný beh API.
Otvoriť krok →Dni 5-7
Vytvoriť výstup výskumu
Pridajte očakávania alebo malú skupinu makro sérií a následne vytvorte jedno uložené porovnanie, tabuľku alebo výsledkovú tabuľku.
Otvoriť krok →Dni 8-10
Automatizujte aktualizácie
Vyberte naplánované REST, SSE alebo webhooky a dokončite ďalší úspešný beh API v iný deň.
Otvoriť krok →Dni 11-13
Zosilnite klienta
Pridajte timeouty, obmedzené pokusy o opakovanie, validáciu odpovedí, bezpečné logovanie prístupových údajov a monitorovanie zastaraných dát.
Otvoriť krok →Deň 14
Preskúmať dôkazy
Potvrďte, že API poskytuje opakovateľnú prácu, ktorú váš tím ponechá, potom vyberte ďalšiu sadu dát alebo pracovný postup aplikácie.
Otvoriť krok →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.
Fungujúci príklad
Uchovajte svoj kľúč v FXMD_API_KEY; nikdy ho nevkladajte do zdrojovej kontroly.
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čakávaný výsledok: A persistent filtered stream. When an event arrives, your worker fetches the related announcements endpoint and updates its local cache.
Keď sa prvý skript stane reálnym systémom
Riešenie problémov a produkčné smernice
Používajte tieto príručky, keď odpoveď zlyhá, nevracia žiadne dáta alebo vyžaduje produkčné kontroly, ako sú cache, timeouty, opakovania a doručovanie udalostí.
| Príručka | Použite to, keď | Štart |
|---|---|---|
| Diagnostikujte zlyhanú alebo prázdnu odpoveď | Oddielte problémy s autentifikáciou, prístupom, cestou, limitom rýchlosti a dostupnosťou dát bez odhalenia vášho kľúča. | Otvormu sprievodca → |
| Urobte API klienta pripraveným na produkciu | Pridajte timeouty, obmedzené pokusy o opakovanie, cachovanie, podmienené požiadavky a správny vzor doručenia. | Otvormu sprievodca → |