Dag 0
Bevis adgang
Opret nøglen, gennemfør én autentificeret anmodning, og gem det første svar med dets metadata.
Åbn trin →API workflow-guide
Hvad ønsker du at bygge?
Vælg det resultat, der ligger tættest på dit arbejde. Hver sti giver dig én fungerende anmodning, hvad svaret skal indeholde, hvordan du tjekker at det virkede, og det næste nyttige skridt.
Fem praktiske stier
Start med resultatet, ikke endpoint-listen.
Selected: Harden a client
Sti 1
Hent makrodata
Hent en ren tidsserie og behold kilde- og kvalitetsmetadata ved siden af den.
Sti 2
Planlæg udgivelsesjobs
Brug release-kalenderen til at køre målrettede jobs omkring kendte offentliggørelsestidspunkter.
Sti 3
Mål overraskelser
Kobl pre-release prognoser til den publicerede værdi uden at introducere lookahead bias.
Sti 4
Modtag live-opdateringer
Brug SSE som et ugyldiggørelsessignal, og hent derefter den komplette post fra REST.
Sti 5
Byg en makromodel
Lav en lille gruppe af relaterede indikatorer om til et kildemærket valutakort.
Din 14-dages API prøveperiode
Gå fra første anmodning til et job værd at beholde.
Målet er ikke at besøge hver produktside. Det er at fuldføre nyttigt autentificeret API arbejde, vende tilbage en anden dag og forlade det med et gentageligt datasæt eller applikations-workflow.
Dage 1-2
Gør anmodningen pålidelig
Løs autentificerings- eller filterproblemer og gør det første script til et navngivet, gentageligt job.
Åbn trin →Dage 3-4
Tilføj udgivelsestidspunkt
Brug kalenderen som en anden endpoint-familie og planlæg den næste nyttige API kørsel.
Åbn trin →Dage 5-7
Byg forskningsoutputtet
Tilføj forventninger eller en lille gruppe af makro-serier, og producer derefter én gemt sammenligning, tabel eller scorecard.
Åbn trin →Dage 8-10
Automatiser opdateringer
Vælg planlagt REST, SSE eller webhooks og gennemfør endnu en succesfuld API kørsel på en anden dag.
Åbn trin →Dage 11-13
Hærd klienten
Tilføj timeouts, begrænsede genforsøg, svar-validering, credential-sikker logning og overvågning af forældede data.
Åbn trin →Dag 14
Gennemse beviser
Bekræft at API leverer et gentageligt job, som dit team vil beholde, og vælg derefter det næste datasæt eller applikations-workflow.
Åbn trin →Production readiness
Gør en API klient produktionsklar
Production reliability comes from treating status codes differently, keeping retries bounded, reusing ETags, and choosing scheduled REST, SSE, or webhooks for the job.
Fungerende eksempel
Hold din nøgle i FXMD_API_KEY; indsæt det aldrig i kildekontrol.
import os
import requests
from urllib3.util.retry import Retry
session = requests.Session()
retry = Retry(total=3, backoff_factor=0.5, status_forcelist=(429, 502, 503, 504))
session.mount("https://", requests.adapters.HTTPAdapter(max_retries=retry))
response = session.get(
"https://api.fxmacrodata.com/v1/announcements/eur/inflation",
params={"api_key": os.environ["FXMD_API_KEY"], "limit": 5},
headers={"Accept-Encoding": "gzip"},
timeout=(3.05, 20),
)
response.raise_for_status()Forventet resultat: A bounded client that handles transient failures without retry storms and is ready to add ETag-based conditional refreshes.
Når det første script bliver til et rigtigt system
Fejlfinding og produktionsvejledning
Brug disse guider, når et svar fejler, returnerer ingen data eller kræver produktionskontroller såsom caching, timeouts, retries og event-levering.
| Guide | Brug det når | Start |
|---|---|---|
| Diagnosticer et fejlslagent eller tomt svar | Adskil problemer med autentificering, adgang, sti, rate-limit og datatilgængelighed uden at eksponere din nøgle. | Åbn guide → |
| Gør en API klient produktionsklar | Tilføj timeouts, begrænsede retries, caching, betingede anmodninger og det rette leveringsmønster. | Åbn guide → |