Deň 0
Dokázať prístup
Vytvorte kľúč, dokončite jeden autentifikovaný request a uložte prvú odpoveď s jej metadata.
Otvoriť krok →príručka k workflow API
Čo chcete vybudovať?
Vyberte výsledok najbližší vašej práci. Každá cesta vám poskytne jeden funkčný request, informáciu o tom, čo by mala odpoveď obsahovať, ako skontrolovať, či fungovala, a ďalší užitočný krok.
Päť praktických ciest
Začnite s výsledkom, nie so zoznamom endpointov.
Selected: Troubleshoot a request
Cesta 1
Získať makro dáta
Získajte čistý časový rad a ponechajte pri ňom metadata o zdroji a kvalite.
Cesta 2
Plánovať úlohy publikovania
Použite kalendár vydaní na spustenie cielených úloh okolo známych časov publikácie.
Cesta 3
Meriať prekvapenia
Pripojte predvydaní prognózy k publikovanej hodnote bez zavedenia lookahead bias.
Cesta 4
Prijať live aktualizácie
Použite SSE ako signál neplatnosti, potom získajte celý záznam z REST.
Cesta 5
Vytvoriť makro model
Premeňte malú skupinu súvisiacich indikátorov na scorecard meny s označeným zdrojom.
Vaša 14-dňová API skúška
Prejdite od prvého requestu k práci, za ktorú stojí stáť.
Cieľom nie je navštíviť každú stránku produktu. Cieľom je dokončiť užitočnú autentifikovanú API prácu, vrátiť sa v ďalší deň a odísť s opakovateľnou sadou dát alebo pracovným postupom aplikácie.
Dni 1-2
Urobte request spoľahlivým
Vyriešte problémy s autentifikáciou alebo filtrom a premeňte prvý skript na pomenovanú opakovateľnú úlohu.
Otvoriť krok →Dni 3-4
Pridať načasovanie vydania
Použite kalendár ako druhú rodinu endpointov a naplánujte ďalší užitočný beh API.
Otvoriť krok →Dni 5-7
Vytvoriť výstup výskumu
Pridajte očakávania alebo malú skupinu makro sérií a následne vytvorte jedno uložené porovnanie, tabuľku alebo výsledkovú tabuľku.
Otvoriť krok →Dni 8-10
Automatizujte aktualizácie
Vyberte naplánované REST, SSE alebo webhooky a dokončite ďalší úspešný beh API v iný deň.
Otvoriť krok →Dni 11-13
Zosilnite klienta
Pridajte timeouty, obmedzené pokusy o opakovanie, validáciu odpovedí, bezpečné logovanie prístupových údajov a monitorovanie zastaraných dát.
Otvoriť krok →Deň 14
Preskúmať dôkazy
Potvrďte, že API poskytuje opakovateľnú prácu, ktorú váš tím ponechá, potom vyberte ďalšiu sadu dát alebo pracovný postup aplikácie.
Otvoriť krok →Request help
Diagnostikujte zlyhanú alebo prázdnu odpoveď
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.
Fungujúci príklad
Uchovajte svoj kľúč v FXMD_API_KEY; nikdy ho nevkladajte do zdrojovej kontroly.
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])Očakávaný výsledok: 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.
Keď sa prvý skript stane reálnym systémom
Riešenie problémov a produkčné smernice
Používajte tieto príručky, keď odpoveď zlyhá, nevracia žiadne dáta alebo vyžaduje produkčné kontroly, ako sú cache, timeouty, opakovania a doručovanie udalostí.
| Príručka | Použite to, keď | Štart |
|---|---|---|
| Diagnostikujte zlyhanú alebo prázdnu odpoveď | Oddielte problémy s autentifikáciou, prístupom, cestou, limitom rýchlosti a dostupnosťou dát bez odhalenia vášho kľúča. | Otvormu sprievodca → |
| Urobte API klienta pripraveným na produkciu | Pridajte timeouty, obmedzené pokusy o opakovanie, cachovanie, podmienené požiadavky a správny vzor doručenia. | Otvormu sprievodca → |