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: Plan release jobs

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.

Kontrollera API framsteg

Dag 0

Bevisa åtkomst

Skapa nyckeln, genomför en autentiserad begäran och spara det första svaret med dess metadata.

Öppna steg →

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 →

Scheduled workflow

Plan around confirmed releases

The calendar tells your scheduler when a release is expected. Your job can then fetch the full announcement record after publication instead of polling every series continuously.

15 minutes Core workflow kalenderannonseringar

Arbetande exempel

Behåll din nyckel i FXMD_API_KEY; klistra aldrig in den i versionshantering.

from datetime import date, timedelta
import os
import requests

events = requests.get(
    "https://api.fxmacrodata.com/v1/calendar/eur",
    params={
        "api_key": os.environ["FXMD_API_KEY"],
        "start_date": date.today().isoformat(),
        "end_date": (date.today() + timedelta(days=14)).isoformat(),
        "timezone": "UTC",
    },
    timeout=20,
).json()["data"]
print(events[:3])

Förväntat resultat: Upcoming EUR releases with dates, times, indicator paths, and confirmation fields that your scheduler can evaluate before creating a job.

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.

GuideAnvänd den närStarta
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 →