Fejlesztőknek
Az API v1 nyilvános, kulcs nélkül használható. A kliensek csak a domainnevet küldik; az útvonalat, sémát vagy portot tartalmazó címeket az API elutasítja. A válaszok UTF‑8 JSON, a hibák { "error": "…" }.
Alap: https://dvojnik.ystvan.com/api/v1
Végpontok
| Metódus és útvonal | Leírás |
|---|---|
GET /health | szolgáltatás állapota, gyorsítótár nélkül |
GET /blocklist | megerősített kockázatos domainek: {version, count, sources[], domains:[[domain, forrás],…]}. ETag + If-None-Match → 304. A kliensnek meg kell jelenítenie a forrás feltüntetését (sources[].attribution). |
GET /known-shops | ismert boltok hasonlóság-összevetéshez: {version, count, shops:[…]}, ETag mint fent |
GET /domain?name=pelda.hu | tiltólista-egyezés, ismert bolt, domain kora (age.status: found | not-registered | unknown) |
POST /reports | törzs {domain, category, note?}; category: fake-shop | phishing-payment | fake-carrier | other. 201 id-vel; egy héten belüli duplikátum → 200 az eredeti id-vel; napi 20-as korlát → 429 |
GET /reports/{id} | jelentés állapota: received | verifying | confirmed | rejected |
curl "https://dvojnik.ystvan.com/api/v1/domain?name=alza.cz"
Közös mag
A bővítmény, a mobilalkalmazás és az API ugyanazt a magot használja (@dvojnik/core): domainelemzés (punycode, váz az összetéveszthető karakterekhez), hasonlóságkeresés ismert boltokhoz, pontozás és szövegek. Ezért ad a böngésző és a telefon azonos eredményt.
Bővítmény fejlesztéshez és teszteléshez
A bővítmény kicsomagolva is betölthető: Chrome/Edge esetén a chrome://extensions oldalon kapcsolja be a fejlesztői módot, és válassza a „Kicsomagolt bővítmény betöltése” lehetőséget a build mappával; Firefoxban about:debugging → „Ideiglenes kiegészítő betöltése”. Az automatizált tesztek Playwrightot használnak --load-extension paraméterrel.
Tesztmód: a .localhost végű cím az utótag előtti domainként értékelődik (alza-vyprodej.cz.localhost → alza-vyprodej.cz), így valódi kockázatos oldal felkeresése nélkül tesztelhet.
Az API használatának szabályai
- Ne küldjön teljes címeket vagy személyes adatokat; a jelentés megjegyzésében semmit, ami személyt azonosít.
- Tartsa tiszteletben az ETag-et és a gyorsítótárat (s-maxage=300 a listáknál) – elég néhány óránként frissíteni.
- A tiltólista megjelenítésekor tüntesse fel a forrást (ČOI), és a listázást kockázati jelként fogalmazza meg, ne csalás bizonyítékaként.