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 putanja | Opis |
|---|---|
GET /health | stanje usluge, bez predmemorije |
GET /blocklist | potvrđene rizične domene: {version, count, sources[], domains:[[domena, izvor],…]}. ETag + If-None-Match → 304. Klijent mora prikazati navod izvora (sources[].attribution). |
GET /known-shops | poznate trgovine za usporedbu sličnosti: {version, count, shops:[…]}, ETag kao gore |
GET /domain?name=primjer.hr | podudaranje s popisom, poznata trgovina, starost domene (age.status: found | not-registered | unknown) |
POST /reports | tijelo {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.