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 pot | Opis |
|---|---|
GET /health | stanje storitve, brez predpomnilnika |
GET /blocklist | potrjene tvegane domene: {version, count, sources[], domains:[[domena, vir],…]}. ETag + If-None-Match → 304. Odjemalec mora prikazati navedbo vira (sources[].attribution). |
GET /known-shops | znane trgovine za primerjavo podobnosti: {version, count, shops:[…]}, ETag kot zgoraj |
GET /domain?name=primer.si | ujemanje s seznamom, znana trgovina, starost domene (age.status: found | not-registered | unknown) |
POST /reports | telo {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.