Pro vývojáře

API v1 je veřejné a bez klíče. Klienti posílají jen název domény; adresy s cestou, schématem nebo portem API odmítne. Odpovědi jsou JSON v UTF‑8, chyby { "error": "…" }.

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

Koncové body

Metoda a cestaPopis
GET /healthstav služby, bez cache
GET /blocklistpotvrzené rizikové domény: {version, count, sources[], domains:[[domena, zdroj],…]}. ETag + If-None-Match → 304. Klient musí zobrazit uvedení zdroje (sources[].attribution).
GET /known-shopsznámé obchody pro porovnání podobnosti: {version, count, shops:[…]}, ETag jako výše
GET /domain?name=priklad.czshoda s blocklistem, známý obchod, stáří domény (age.status: found | not-registered | unknown)
POST /reportstělo {domain, category, note?}; category: fake-shop | phishing-payment | fake-carrier | other. 201 s id; duplicita v týdnu → 200 s původním id; limit 20/den → 429
GET /reports/{id}stav hlášení: received | verifying | confirmed | rejected
curl "https://dvojnik.ystvan.com/api/v1/domain?name=alza.cz"

Sdílené jádro

Rozšíření, mobilní aplikace i API používají stejné jádro (@dvojnik/core): rozbor domény (punycode, kostra pro porovnání zaměnitelných znaků), hledání podobnosti se známými obchody, výpočet skóre a texty. Díky tomu dává web i telefon stejný výsledek.

Rozšíření pro vývojáře a testování

Rozšíření lze načíst nezabalené: v Chrome/Edge na chrome://extensions zapněte režim vývojáře a zvolte „Načíst rozbalené“ se složkou sestavení; ve Firefoxu about:debugging → „Načíst dočasný doplněk“. Pro automatizované zkoušení používáme Playwright s parametrem --load-extension.

Testovací režim: adresa končící na .localhost se vyhodnotí jako doména před touto příponou (alza-vyprodej.cz.localhost → alza-vyprodej.cz), takže se dá zkoušet bez návštěvy skutečného rizikového webu.

Pravidla použití API

  • Neposílejte celé adresy ani osobní údaje; v poznámce k hlášení nic, co identifikuje osobu.
  • Respektujte ETag a cache (s-maxage=300 u seznamů) – seznamy stačí obnovovat jednou za několik hodin.
  • Při zobrazení blocklistu uveďte zdroj (ČOI) a formulujte zařazení jako rizikové znaky, ne jako důkaz podvodu.