Dag 0
Bevis tilgang
Opprett nøkkelen, fullfør én autentisert forespørsel, og lagre det første svaret med tilhørende metadata.
Åpne trinn →API arbeidsflytguide
Hva ønsker du å bygge?
Velg resultatet som ligger nærmest din jobb. Hver bane gir deg én fungerende forespørsel, hva responsen skal inneholde, hvordan du sjekker at det fungerte, og neste nyttige steg.
Fem praktiske veier
Start med resultatet, ikke endepunktlisten.
Valgt: Hent makrodata
Bane 1
Hent makrodata
Hent en ren tidsserie og behold kilde- og kvalitetsmetadata ved siden av den.
Sti 2
Planlegg utgivelsesjobber
Bruk utgivelseskalenderen til å kjøre målrettede jobber rundt kjente publiseringstider.
Sti 3
Mål overraskelser
Koble forhåndsutgitte prognoser til den publiserte verdien uten å introdusere lookahead-bias.
Bane 4
Motta live-oppdateringer
Bruk SSE som et ugyldiggjøringssignal, og hent deretter den fullstendige posten fra REST.
Sti 5
Bygg en makromodell
Gjør en liten gruppe relaterte indikatorer om til et kildemerket valutakort.
Din 14-dagers API prøveperiode
Gå fra første forespørsel til en jobb det er verdt å beholde.
Målet er ikke å besøke hver produktside. Det er å fullføre nyttig autentisert API arbeid, komme tilbake en annen dag, og dra med et repeterbart datasett eller en arbeidsflyt for applikasjoner.
Dager 1-2
Gjør forespørselen pålitelig
Løs autentiserings- eller filterproblemer og gjør det første skriptet til en navngitt repeterbar jobb.
Åpne trinn →Dager 3-4
Legg til utgivelsestidspunkt
Bruk kalenderen som en andre endepunktfamilie og planlegg neste nyttige API kjøring.
Åpne trinn →Dager 5-7
Bygg forskningsresultatet
Legg til forventninger eller en liten gruppe makroserier, og produser deretter én lagret sammenligning, tabell eller resultatkort.
Åpne trinn →Dager 8-10
Automatiser oppdateringer
Velg planlagt REST, SSE, eller webhooks og fullfør en annen vellykket API kjøring på en annen dag.
Åpne trinn →Dager 11-13
Forsterk klienten
Legg til tidsavbrudd, begrensede gjentakelser, responsvalidering, legitimasjonssikker logging og overvåking av utdaterte data.
Åpne trinn →Dag 14
Gjennomgå bevis
Bekreft at API leverer en repeterbar jobb teamet ditt vil beholde, og velg deretter neste datasett eller applikasjonsarbeidsflyt.
Åpne trinn →Første forespørsel
Hent og lagre makrohistorikk
Start med én valuta og indikator du allerede forstår. Dette gjør det enkelt å verifisere autentisering, responsformat, paginering og lagring før du legger til flere serier.
Fungerende eksempel
Oppbevar nøkkelen din i FXMD_API_KEY; lim det aldri inn i kildekontroll.
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])Forventet resultat: Et 200 svar med nylige EUR inflasjonsobservasjoner pluss svar-metadata som beskriver serien, kilden, paginering og datakvalitet.
Når det første skriptet blir et ekte system
Feilsøking og produksjonsveiledning
Bruk disse guidene når en respons feiler, ikke returnerer data, eller trenger produksjonskontroller som caching, timeouts, retries og hendelseslevering.
| Guide | Bruk det når | Start |
|---|---|---|
| Diagnostiser et mislykket eller tomt svar | Sondre mellom problemer med autentisering, tilgang, sti, hastighetsbegrensning og datatilgjengelighet uten å eksponere nøkkelen din. | Åpne guide → |
| Gjør en API klient produksjonsklar | Legg til tidsavbrudd, begrensede gjentakelser, caching, betingede forespørsler og riktig leveringsmønster. | Åpne guide → |