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.
Selected: Troubleshoot a request
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 →Request help
Diagnosoi epäonnistunut tai tyhjä vastaus
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.
Toimiva esimerkki
Pidä avaimesi FXMD_API_KEY; älä koskaan liitä sitä versionhallintaan.
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])Odotettu tulos: 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.
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 → |