Dag 0
Bewys toegang
Skep die sleutel, voltooi een outentisiteitsversoek, en stoor die eerste antwoord met sy metadata.
Maak stap oop →API werkvloei gids
Wat wil u bou?
Kies die uitkoms wat die naaste aan jou werk is. Elke pad gee jou een werkende versoek, wat die antwoord moet bevat, hoe om te kontroleer of dit gewerk het, en die volgende nuttige stap.
Vyf praktiese paaie
Begin met die uitkoms, nie die eindpuntlys nie.
Geselekteer: Haal makro-data
Pad 1
Haal makro-data op
Haal 'n skoon tydreeks op en hou die bron- en gehalte-metadata daarnaas.
Pad 2
Beplan vrystellingsposte
Gebruik die vrystellingskalender om geteikende take rondom bekende publikasietye uit te voer.
Pad 3
Meet verrassings
Voeg voor-vrystelling voorspellings by die gepubliseerde waarde sonder om vooruitsig-vooroordeel (lookahead bias) te introduseer.
Pad 4
Ontvang lewendige opdaterings
Gebruik SSE as 'n ongeldigheidssein, en haal dan die volledige rekord vanaf REST.
Pad 5
Bou 'n makro-model
Verander 'n klein groep verwante aanwysers in 'n bron-gelabelde valuta-streskaart.
Jou 14-dae API proeftydperk
Skuif van die eerste versoek na 'n werk wat die moeite werd is om te behou.
Die doel is nie om elke produkblad te besoek nie. Dit is om nuttige outentisiekte API werk te voltooi, op 'n ander dag terug te keer, en weg te gaan met 'n herhaalbare datastel of toepassing-werkvloei.
Dae 1-2
Maak die versoek betroubaar
Los outentisering of filterprobleme op en verander die eerste skrip in 'n benoemde herhaalbare taak.
Maak stap oop →Dae 3-4
Voeg vrystellingstyd by
Gebruik die kalender as 'n tweede eindpuntfamilie en skeduleer die volgende nuttige API uitvoering.
Maak stap oop →Dae 5-7
Bou die navorsingsuitset
Voeg verwagtinge of 'n klein groep makro-reekse by, en produseer dan een gestoorde vergelyking, tabel, of puntekaart.
Maak stap oop →Dae 8-10
Outomatiseer opdaterings
Kies geskeduleerde REST, SSE, of webhooks en voltooi nog 'n suksesvolle API loop op 'n ander dag.
Maak stap oop →Dae 11-13
Verhard die kliënt
Voeg afdraaitye, begrensde herhalings, antwoordvalidering, geloofwaardigheid-veilige logging, en ou-data-monitering by.
Maak stap oop →Dag 14
Hersien bewysstukke
Bevestig dat die API 'n herhaalbare werk verskaf wat jou span sal behou, en kies dan die volgende datastel of toepassing-werkvloei.
Maak stap oop →Eerste versoek
Haal makro-geskiedenis op en stoor dit
Begin met een valuta en aanwyser wat u reeds verstaan. Dit maak outentisering, antwoordvorm, bladsy-indeling en berging maklik om te verifieer voordat u meer reekse byvoeg.
Werkende voorbeeld
Hou jou sleutel in FXMD_API_KEY; plak dit nooit in bronbeheer nie.
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])Verwagte resultaat: 'n 200 antwoord met onlangse EUR inflasie-waarnemings plus antwoord-metadata wat die reeks, bron, bladsy-indeling, en datakwaliteit beskryf.
Wanneer die eerste skrip 'n regte stelsel word
Probleemoplossing en produksie-begeleiding
Gebruik hierdie gidse wanneer 'n antwoord misluk, geen data terugstuur nie, of produksiebeheer soos kasering, aftydperke, herhalings en gebeurtenisaflewering benodig.
| Gids | Gebruik dit wanneer | Begin |
|---|---|---|
| Diagnoseer 'n mislukte of leë antwoord | Skeid outentisering, toegang, pad, spoedbeperking, en databeskikbaarheidsprobleme sonder om jou sleutel bloot te stel. | Maak gids oop → |
| Maak 'n API kliënt produksiegereed | Voeg aftydperke, begrensde herhalings, kasering, voorwaardelike versoeke, en die regte afleweringspatroon by. | Maak gids oop → |