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šč.
Selected: Troubleshoot a request
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 →Request help
Diagnosticirajte neuspešen ali prazen odgovor
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.
Delujoč primer
Svoj ključ shranite v FXMD_API_KEY; nikoli ga ne prilepite v nadzor nad viri.
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])Pričakovani rezultat: 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.
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 → |