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 cesta | Popis |
|---|---|
GET /health | stav služby, bez cache |
GET /blocklist | potvrzené rizikové domény: {version, count, sources[], domains:[[domena, zdroj],…]}. ETag + If-None-Match → 304. Klient musí zobrazit uvedení zdroje (sources[].attribution). |
GET /known-shops | známé obchody pro porovnání podobnosti: {version, count, shops:[…]}, ETag jako výše |
GET /domain?name=priklad.cz | shoda s blocklistem, známý obchod, stáří domény (age.status: found | not-registered | unknown) |
POST /reports | tě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.