Dag 0
Toegang bewijzen
Maak de sleutel aan, voltooi één geauthenticeerde aanvraag en sla de eerste respons op met de bijbehorende metadata.
Open stap →API workflow gids
Wat wilt u bouwen?
Kies de uitkomst die het dichtst bij uw taak ligt. Elk pad geeft u één werkend verzoek, wat de respons moet bevatten, hoe u controleert of het gewerkt heeft, en de volgende nuttige stap.
Vijf praktische paden
Begin bij het resultaat, niet bij de lijst met endpoints.
Selected: Measure surprises
Pad 1
Haal macro-data op
Haal een schone tijdreeks op en houd de bron- en kwaliteitsmetadata ernaast.
Pad 2
Plan publicatie-jobs
Gebruik de publicatiekalender om gerichte jobs uit te voeren rond bekende publicatietijden.
Pad 3
Meet verrassingen
Voeg pre-release voorspellingen samen met de gepubliceerde waarde zonder lookahead bias te introduceren.
Pad 4
Ontvang live updates
Gebruik SSE als een ongeldig signaal, en haal vervolgens het volledige record op uit REST.
Pad 5
Bouw een macro-model
Verander een kleine groep gerelateerde indicatoren in een bron-gelabelde valuta-scorekaart.
Uw 14-daagse API proefperiode
Ga van de eerste aanvraag naar een baan die het waard is om te behouden.
Het doel is niet om elke productpagina te bezoeken. Het doel is om nuttig geauthenticeerd API werk te voltooien, op een andere dag terug te keren, en weg te gaan met een herhaalbare dataset of applicatie-workflow.
Dagen 1-2
Maak de request betrouwbaar
Los authenticatie- of filterproblemen op en verander het eerste script in een benoemde, herhaalbare taak.
Open stap →Dagen 3-4
Release timing toevoegen
Gebruik de kalender als een tweede endpoint-familie en plan de volgende nuttige API run.
Open stap →Dagen 5-7
Bouw de onderzoeksoutput
Voeg verwachtingen of een kleine groep macro-series toe, en genereer vervolgens één opgeslagen vergelijking, tabel of scorecard.
Open stap →Dagen 8-10
Updates automatiseren
Kies geplande REST, SSE, of webhooks en voltooi een andere succesvolle API run op een andere dag.
Open stap →Dagen 11-13
Verstevig de client
Voeg timeouts, begrensde retries, responsvalidatie, credential-veilige logging en stale-data monitoring toe.
Open stap →Dag 14
Beoordeel bewijs
Bevestig dat de API een herhaalbare taak levert die uw team zal behouden, en kies dan de volgende dataset of applicatieworkflow.
Open stap →Expectations workflow
Compare forecasts with actual releases
Use predictions before the event, preserve the forecast timestamp, then join the released observation by announcement identity for a repeatable surprise series.
Werkend voorbeeld
Bewaar je sleutel in FXMD_API_KEY; plak het nooit in source control.
import os
import requests
params = {
"api_key": os.environ["FXMD_API_KEY"],
"pre_release_only": "true",
"limit": 5,
}
response = requests.get(
"https://api.fxmacrodata.com/v1/predictions/eur/inflation",
params=params,
timeout=20,
)
response.raise_for_status()
print(response.json()["data"][0])Verwacht resultaat: Recent EUR inflation release groups with source-labelled forecasts that were recorded before each announcement.
Wanneer het eerste script een echt systeem wordt
Probleemoplossing en productiegeridance
Gebruik deze gidsen wanneer een reactie mislukt, geen gegevens retourneert, of productiecontroles nodig heeft zoals caching, timeouts, retries en event delivery.
| Gids | Gebruik het wanneer | Start |
|---|---|---|
| Diagnoseer een mislukte of lege respons | Scheid authenticatie-, toegang-, pad-, rate-limit- en beschikbaarheidsproblemen van data zonder uw sleutel bloot te leggen. | Open gids → |
| Maak een API client productie-klaar | Voeg timeouts, beperkte retries, caching, conditionele verzoeken en het juiste leveringspatroon toe. | Open gids → |