Dan 0
Dokazati dostop
Ustvarite ključ, izvedite en avtoriziran zahtev, in shranite prvi odgovor z njegovimi metapodatki.
Odpri korak →vodič za delovni proces API
Kaj želite zgraditi?
Izberite rezultat, ki je najbližji vašemu delu. Vsaka pot vam nudi eno delujočo zahtevo, vsebino odgovora, način preverjanja delovanja in naslednji korak.
Pet praktičnih poti
Začnite s rezultatom, ne s seznamom končališč.
Izbrano: Pridobivanje makro podatkov
Pot 1
Pridobite makro podatke
Pridobite čisto časovno serijo in ob njej shranite metapodatke o viru in kakovosti.
Pot 2
načrtuj naloge objav
Uporabite koledar izdaj za izvajanje ciljanih opravil okoli znanih časov objave.
Pot 3
Merite presenečenja
Povežite napovedi pred izdajo z objavljeno vrednostjo, ne da bi uvedli pristranskost predogleda (lookahead bias).
Pot 4
Prejemajte v živo posodobitve
Uporabite SSE kot signal za invalidacijo, nato pa pridobite celoten zapis iz REST.
Pot 5
Zgradite makro model
Prevedite majhno skupino povezanih indikatorjev v valutno tabelo z oznakami virov.
Vaše API brezplačno preizkusno obdobje za 14 dni
Prehod od prvega zahtevka do opravila, ki se splača.
Cilj ni obiskovanje vsake strani izdelka. Cilj je opraviti uporabne avtentikirane API naloge, se vrniti drugega dne in oditi z ponovljivim naborom podatkov ali delovnim procesom aplikacije.
Dni 1-2
Naredite zahtevo zanesljivo
Rešite težave z avtentikacijo ali filtri in prvi skript spremenite v poimenjeno ponovljivo nalogo.
Odpri korak →Dni 3-4
Dodaj čas objave
Uporabite koledar kot drugo družino končališč in načrtujte naslednji uporaben API ciklus.
Odpri korak →Dni 5-7
Zgradite raziskovalni izhod
Dodajte pričakovanja ali majhno skupino makro serij, nato pa izdelajte eno shranjeno primerjavo, tabelo ali tabelo rezultatov.
Odpri korak →Dnevi 8-10
Avtomatizirajte posodobitve
Izberite načrtovane REST, SSE ali spletne klicaje (webhooks) in zaključite drugo uspešno izvedbo API na drug dan.
Odpri korak →Dni 11-13
Okrepite klijenta
Dodajte časovne omejitve, omejene ponovne poskuse, validacijo odgovora, varno beleženje podatkov in spremljanje zastarelih podatkov.
Odpri korak →Dan 14
Preglej dokaze
Potrdite, da API zagotavlja ponovljivo opravilo, ki ga bo vaša ekipa izvajala, nato pa izberite naslednji nabor podatkov ali delovni proces aplikacije.
Odpri korak →Prvo zahtevo
Pridobite in shranite makro zgodovino
Začnite z eno valuto in indikatorjem, ki ga že razumete. To omogoča enostavno preverjanje avtentikacije, oblike odziva, paginacije in shranjevanja, preden dodate več serij.
Delujoč primer
Svoj ključ shranite v FXMD_API_KEY; nikoli ga ne prilepite v nadzor nad viri.
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])Pričakovani rezultat: Odgovor 200 z nedavnimi EUR opazovanji inflacije, veljavnimi metapodatki odgovora, ki opisujejo serijo, vir, paginacijo in kakovost podatkov.
Ko prvi skript postane pravi sistem
Reševanje težav in vodstvo za produkcijo
Uporabite te priročnike, ko odgovor ne uspe, ne vrne podatkov ali zahteva produkcijskih nadzornih funkcij, kot so predpomnjeno shranjevanje, časovni izlivi, ponovni poskusi in dostava dogodkov.
| Navodilo | Uporabite, ko | Začni |
|---|---|---|
| Diagnosticirajte neuspešen ali prazen odgovor | Ločite težave z avtentikacijo, dostopom, potjo, omejitvijo hitrosti in razpoložljivostjo podatkov, ne da bi razkrili svoj ključ. | Odpri vodnik → |
| Naredite API klijenta pripravljenega na produkcijo | Dodajte časovne omejitve, omejene ponovni poskuse, predpomnjeno, pogojne zahteve in ustrezen vzorec dostave. | Odpri vodnik → |