Pre vývojárov

API v1 je verejné a bez kľúča. Klienti posielajú len názov domény; adresy s cestou, schémou alebo portom API odmietne. Odpovede sú JSON v UTF‑8, chyby { "error": "…" }.

Základ: https://dvojnik.ystvan.com/api/v1

Koncové body

Metóda a cestaPopis
GET /healthstav služby, bez cache
GET /blocklistpotvrdené rizikové domény: {version, count, sources[], domains:[[domena, zdroj],…]}. ETag + If-None-Match → 304. Klient musí zobraziť uvedenie zdroja (sources[].attribution).
GET /known-shopsznáme obchody na porovnanie podobnosti: {version, count, shops:[…]}, ETag ako vyššie
GET /domain?name=priklad.skzhoda s blocklistom, známy obchod, vek domény (age.status: found | not-registered | unknown)
POST /reportstelo {domain, category, note?}; category: fake-shop | phishing-payment | fake-carrier | other. 201 s id; duplicita v týždni → 200 s pôvodným id; limit 20/deň → 429
GET /reports/{id}stav hlásenia: received | verifying | confirmed | rejected
curl "https://dvojnik.ystvan.com/api/v1/domain?name=alza.cz"

Zdieľané jadro

Rozšírenie, mobilná aplikácia aj API používajú rovnaké jadro (@dvojnik/core): rozbor domény (punycode, kostra na porovnanie zameniteľných znakov), hľadanie podobnosti so známymi obchodmi, výpočet skóre a texty. Vďaka tomu dáva web aj telefón rovnaký výsledok.

Rozšírenie pre vývojárov a testovanie

Rozšírenie možno načítať nezabalené: v Chrome/Edge na chrome://extensions zapnite režim vývojára a zvoľte „Načítať rozbalené“ s priečinkom zostavenia; vo Firefoxe about:debugging → „Načítať dočasný doplnok“. Na automatizované skúšanie používame Playwright s parametrom --load-extension.

Testovací režim: adresa končiaca na .localhost sa vyhodnotí ako doména pred touto príponou (alza-vyprodej.cz.localhost → alza-vyprodej.cz), takže sa dá skúšať bez návštevy skutočného rizikového webu.

Pravidlá použitia API

  • Neposielajte celé adresy ani osobné údaje; v poznámke k hláseniu nič, čo identifikuje osobu.
  • Rešpektujte ETag a cache (s-maxage=300 pri zoznamoch) – zoznamy stačí obnovovať raz za niekoľko hodín.
  • Pri zobrazení blocklistu uveďte zdroj (ČOI) a formulujte zaradenie ako rizikové znaky, nie ako dôkaz podvodu.