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: Harden a client
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 →Production readiness
Urobte API klienta pripraveným na produkciu
Production reliability comes from treating status codes differently, keeping retries bounded, reusing ETags, and choosing scheduled REST, SSE, or webhooks for the job.
Fungujúci príklad
Uchovajte svoj kľúč v FXMD_API_KEY; nikdy ho nevkladajte do zdrojovej kontroly.
import os
import requests
from urllib3.util.retry import Retry
session = requests.Session()
retry = Retry(total=3, backoff_factor=0.5, status_forcelist=(429, 502, 503, 504))
session.mount("https://", requests.adapters.HTTPAdapter(max_retries=retry))
response = session.get(
"https://api.fxmacrodata.com/v1/announcements/eur/inflation",
params={"api_key": os.environ["FXMD_API_KEY"], "limit": 5},
headers={"Accept-Encoding": "gzip"},
timeout=(3.05, 20),
)
response.raise_for_status()Očakávaný výsledok: A bounded client that handles transient failures without retry storms and is ready to add ETag-based conditional refreshes.
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 → |