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 cesta | Popis |
|---|---|
GET /health | stav služby, bez cache |
GET /blocklist | potvrdené rizikové domény: {version, count, sources[], domains:[[domena, zdroj],…]}. ETag + If-None-Match → 304. Klient musí zobraziť uvedenie zdroja (sources[].attribution). |
GET /known-shops | známe obchody na porovnanie podobnosti: {version, count, shops:[…]}, ETag ako vyššie |
GET /domain?name=priklad.sk | zhoda s blocklistom, známy obchod, vek domény (age.status: found | not-registered | unknown) |
POST /reports | telo {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.