Dag 0
Bevisa åtkomst
Skapa nyckeln, genomför en autentiserad begäran och spara det första svaret med dess metadata.
Öppna steg →API arbetsflödesguide
Vad vill du bygga?
Välj det utfall som ligger närmast ditt jobb. Varje väg ger dig en fungerande förfrågan, vad responsen bör innehålla, hur du kontrollerar att det fungerade, och nästa användbara steg.
Fem praktiska vägar
Börja med resultatet, inte listan över endpoints.
Selected: Troubleshoot a request
Väg 1
Hämta makrodata
Hämta en ren tidsserie och behåll käll- och kvalitetsmetadata bredvid den.
Sökväg 2
Planera publiceringsjobb
Använd release-kalendern för att köra riktade jobb kring kända publiceringstider.
Sökväg 3
Mät överraskningar
Slå samman prognoser före release med det publicerade värdet utan att introducera lookahead-bias.
Väg 4
Ta emot live-uppdateringar
Använd SSE som en ogiltighetsignal, hämta sedan den kompletta posten från REST.
Sökväg 5
Bygg en makromodell
Förvandla en liten grupp relaterade indikatorer till en källmärkta valuta-scorecard.
Din 14-dagars API provperiod
Gå från första förfrågan till ett jobb värt att behålla.
Målet är inte att besöka varje produktsida. Det är att slutföra användbart autentiserat API arbete, återvända en annan dag, och lämna med ett upprepningsbart dataset eller arbetsflöde för applikationer.
Dagar 1-2
Gör förfrågan pålitlig
Lös autentiserings- eller filtreringsproblem och förvandla det första skriptet till ett namngivet upprepningsbart jobb.
Öppna steg →Dagar 3-4
Lägg till släpptidpunkt
Använd kalendern som en andra endpoint-familj och schemalägg nästa användbara API körning.
Öppna steg →Dagar 5-7
Bygg forskningsresultatet
Lägg till förväntningar eller en liten grupp makroserier, och producera sedan en sparad jämförelse, tabell eller scorecard.
Öppna steg →Dagar 8-10
Automatisera uppdateringar
Välj schemalagd REST, SSE, eller webhooks och slutför en annan lyckad API körning på en annan dag.
Öppna steg →Dagar 11-13
Härda klienten
Lägg till timeouts, begränsade retries, validering av respons, autentiseringssäker loggning och övervakning av inaktuell data.
Öppna steg →Dag 14
Granska bevis
Bekräfta att API tillhandahåller ett upprepningsbart jobb som ditt team kommer att behålla, välj sedan nästa dataset eller arbetsflöde för applikationen.
Öppna steg →Request help
Diagnostisera ett misslyckat eller tomt svar
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.
Arbetande exempel
Behåll din nyckel i FXMD_API_KEY; klistra aldrig in den i versionshantering.
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])Förväntat resultat: 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.
När det första skriptet blir ett riktigt system
Felsökning och produktionsvägledning
Använd dessa guider när ett svar misslyckas, inte returnerar data eller behöver produktionskontroller såsom cachelagring, timeouts, försök på nytt och leverans av händelser.
| Guide | Använd den när | Starta |
|---|---|---|
| Diagnostisera ett misslyckat eller tomt svar | Separera autentiserings-, åtkomst-, sökvägs-, hastighetsbegränsnings- och datatillgänglighetsproblem utan att exponera din nyckel. | Öppna guide → |
| Gör en API klient produktionsredo | Lägg till timeouts, begränsade retries, cachning, villkorliga förfrågningar och rätt leveransmönster. | Öppna guide → |