Za programere

API v1 je javan i ne treba ključ. Klijenti šalju samo naziv domene; adrese s putanjom, shemom ili portom API odbija. Odgovori su JSON u UTF‑8, pogreške { "error": "…" }.

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

Krajnje točke

Metoda i putanjaOpis
GET /healthstanje usluge, bez predmemorije
GET /blocklistpotvrđene rizične domene: {version, count, sources[], domains:[[domena, izvor],…]}. ETag + If-None-Match → 304. Klijent mora prikazati navod izvora (sources[].attribution).
GET /known-shopspoznate trgovine za usporedbu sličnosti: {version, count, shops:[…]}, ETag kao gore
GET /domain?name=primjer.hrpodudaranje s popisom, poznata trgovina, starost domene (age.status: found | not-registered | unknown)
POST /reportstijelo {domain, category, note?}; category: fake-shop | phishing-payment | fake-carrier | other. 201 s id; duplikat u tjednu → 200 s izvornim id; ograničenje 20/dan → 429
GET /reports/{id}status prijave: received | verifying | confirmed | rejected
curl "https://dvojnik.ystvan.com/api/v1/domain?name=alza.cz"

Zajednička jezgra

Proširenje, mobilna aplikacija i API koriste istu jezgru (@dvojnik/core): raščlambu domene (punycode, kostur za zamjenjive znakove), traženje sličnosti s poznatim trgovinama, bodovanje i tekstove. Zato preglednik i telefon daju isti rezultat.

Proširenje za razvoj i testiranje

Proširenje se može učitati nepakirano: u Chromeu/Edgeu na chrome://extensions uključite način za programere i odaberite „Učitaj nepakirano“ s mapom izgradnje; u Firefoxu about:debugging → „Učitaj privremeni dodatak“. Automatizirani testovi koriste Playwright s parametrom --load-extension.

Testni način: adresa koja završava na .localhost vrednuje se kao domena prije tog sufiksa (alza-vyprodej.cz.localhost → alza-vyprodej.cz), pa možete testirati bez posjeta stvarnoj rizičnoj stranici.

Pravila korištenja API-ja

  • Ne šaljite cijele adrese ni osobne podatke; u napomeni prijave ništa što identificira osobu.
  • Poštujte ETag i predmemoriju (s-maxage=300 kod popisa) – osvježavanje svakih nekoliko sati je dovoljno.
  • Pri prikazu popisa blokiranih navedite izvor (ČOI) i uvrštenje formulirajte kao znakove rizika, ne kao dokaz prijevare.