Za razvijalce

API v1 je javen in ne potrebuje ključa. Odjemalci pošljejo samo ime domene; naslove s potjo, shemo ali vrati API zavrne. Odgovori so JSON v UTF‑8, napake { "error": "…" }.

Osnova: https://dvojnik.ystvan.com/api/v1

Končne točke

Metoda in potOpis
GET /healthstanje storitve, brez predpomnilnika
GET /blocklistpotrjene tvegane domene: {version, count, sources[], domains:[[domena, vir],…]}. ETag + If-None-Match → 304. Odjemalec mora prikazati navedbo vira (sources[].attribution).
GET /known-shopsznane trgovine za primerjavo podobnosti: {version, count, shops:[…]}, ETag kot zgoraj
GET /domain?name=primer.siujemanje s seznamom, znana trgovina, starost domene (age.status: found | not-registered | unknown)
POST /reportstelo {domain, category, note?}; category: fake-shop | phishing-payment | fake-carrier | other. 201 z id; dvojnik v tednu → 200 z izvirnim id; omejitev 20/dan → 429
GET /reports/{id}stanje prijave: received | verifying | confirmed | rejected
curl "https://dvojnik.ystvan.com/api/v1/domain?name=alza.cz"

Skupno jedro

Razširitev, mobilna aplikacija in API uporabljajo isto jedro (@dvojnik/core): razčlenitev domene (punycode, okostje za zamenljive znake), iskanje podobnosti z znanimi trgovinami, točkovanje in besedila. Zato brskalnik in telefon dasta enak rezultat.

Razširitev za razvoj in testiranje

Razširitev je mogoče naložiti nezapakirano: v Chrome/Edge na chrome://extensions vklopite način za razvijalce in izberite „Naloži nezapakirano“ z mapo gradnje; v Firefoxu about:debugging → „Naloži začasni dodatek“. Samodejni testi uporabljajo Playwright s parametrom --load-extension.

Testni način: naslov, ki se konča na .localhost, se ovrednoti kot domena pred to pripono (alza-vyprodej.cz.localhost → alza-vyprodej.cz), zato lahko testirate brez obiska pravega tveganega mesta.

Pravila uporabe API-ja

  • Ne pošiljajte celotnih naslovov ali osebnih podatkov; v opombi prijave nič, kar bi identificiralo osebo.
  • Spoštujte ETag in predpomnilnik (s-maxage=300 pri seznamih) – osveževanje vsakih nekaj ur zadostuje.
  • Pri prikazu seznama blokiranih navedite vir (ČOI) in uvrstitev opišite kot znake tveganja, ne kot dokaz prevare.