Päivä 0
Todista pääsy
Luo avain, suorita yksi autentikoitu pyyntö ja tallenna ensimmäinen vastaus metadatineen.
Avaa vaihe →API -työnkulkuopas
Mitä haluat rakentaa?
Valitse työllesi lähin lopputulos. Jokainen polku antaa sinulle yhden toimivan pyynnön, tiedon siitä mitä vastauksen tulisi sisältää, ohjeen sen tarkistamiseen ja seuraavan hyödyllisen vaiheen.
Viisi käytännön polkua
Aloita lopputuloksesta, älä päätepistelistasta.
Valittu: Hae makrotietoja
Polku 1
Hae makrotietoja
Hae puhdas aikasarja ja pidä lähde- ja laatumetatiedot sen vieressä.
Polku 2
Suunnittele julkaisutehtävät
Käytä julkaisukalenteria kohdennettujen tehtävien ajamiseen tunnettujen julkaisuajankohtien ympärillä.
Polku 3
Mittaa yllätykset
Yhdistä julkaisun edeltävät ennusteet julkaistuun arvoon ilman lookahead-vinoumaa.
Polku 4
Vastaanota live-päivityksiä
Käytä SSE mitätöintisignaalina, hae sitten koko tietue REST -lähteestä.
Polku 5
Rakenna makromalli
Muuta pieni ryhmä toisiinsa liittyviä indikaattoreita lähteellä merkityksi valuuttataulukoksi.
14-päivän API -kokeilujaksosi
Siirry ensimmäisestä pyynnöstä työhön, joka on säilyttämisen arvoinen.
Tavoitteena ei ole vierailla jokaisella tuotesivulla. Tavoitteena on suorittaa hyödyllinen tunnistettu API -työ, palata toisena päivänä ja poistua toistettavan tietoaineiston tai sovellustyönkulun kanssa.
Päivät 1-2
Tee pyynnöstä luotettava
Ratkaise tunnistautumis- tai suodatinongelmat ja muuta ensimmäinen skripti nimettyä toistettavaksi työksi.
Avaa vaihe →Päivät 3-4
Lisää julkaisuajankohta
Käytä kalenteria toisena päätepisteperheenä ja aikatauluta seuraava hyödyllinen API -ajo.
Avaa vaihe →Päivät 5-7
Rakenna tutkimustulos
Lisää odotuksia tai pieni ryhmä makrosarjoja, ja luo sitten yksi tallennettu vertailu, taulukko tai pisteytyskortti.
Avaa vaihe →Päivät 8-10
Automatisoi päivitykset
Valitse ajastettu REST, SSE tai webhooks ja suorita toinen onnistunut API -ajo eri päivänä.
Avaa vaihe →Päivät 11-13
Vahvista asiakasohjelma
Lisää aikakatkaisut, rajatut uudelleenyritykset, vastauksen validointi, tunnusturvallinen lokitus ja vanhentuneen datan seuranta.
Avaa vaihe →Päivä 14
Tarkista todisteet
Varmista, että API tarjoaa toistettavan työn, jonka tiimisi säilyttää, ja valitse sitten seuraava tietoaineisto tai sovelluksen työnkulku.
Avaa vaihe →Ensimmäinen pyyntö
Hae ja tallenna makrotalouden historia
Aloita yhdellä valuutalla ja indikaattorilla, jotka jo ymmärrät. Tämä tekee autentikoinnin, vastausmuodon, sivutuksen ja tallennuksen helppoa varmistaa ennen kuin lisäät useampia sarjoja.
Toimiva esimerkki
Pidä avaimesi FXMD_API_KEY; älä koskaan liitä sitä versionhallintaan.
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])Odotettu tulos: 200 -vastaus, joka sisältää viimeisimmät EUR inflaatiohavainnot sekä vastausmetadatat, jotka kuvaavat sarjaa, lähdettä, sivutusta ja datan laatua.
Kun ensimmäisestä skriptistä tulee oikea järjestelmä
Vianetsintä ja tuotanto-ohjeistus
Käytä näitä oppaita, kun vastaus epäonnistuu, ei palauta tietoja tai vaatii tuotantokontrolleja, kuten välimuistia, aikakatkaisuja, uudelleenyrityksiä ja tapahtumien toimitusta.
| Opas | Käytä sitä, kun | Aloita |
|---|---|---|
| Diagnosoi epäonnistunut tai tyhjä vastaus | Erota tunnistautumis-, pääsy-, polku-, nopeusrajoitus- ja tietojen saatavuusongelmat paljastamatta avaintasi. | Avaa opas → |
| Tee API -asiakkaasta tuotantovalmis | Lisää aikakatkaisut, rajatut uudelleenyritykset, välimuisti, ehdolliset pyynnöt ja oikea toimitusmalli. | Avaa opas → |