За разработчици
API v1 е публичен и не изисква ключ. Клиентите изпращат само името на домейна; адреси с път, схема или порт се отхвърлят. Отговорите са JSON в UTF‑8, грешките { "error": "…" }.
База: https://dvojnik.ystvan.com/api/v1
Крайни точки
| Метод и път | Описание |
|---|---|
GET /health | състояние на услугата, без кеш |
GET /blocklist | потвърдени рискови домейни: {version, count, sources[], domains:[[домейн, източник],…]}. ETag + If-None-Match → 304. Клиентът трябва да показва посочването на източника (sources[].attribution). |
GET /known-shops | известни магазини за сравнение на сходство: {version, count, shops:[…]}, ETag както по-горе |
GET /domain?name=primer.bg | съвпадение със списъка, известен магазин, възраст на домейна (age.status: found | not-registered | unknown) |
POST /reports | тяло {domain, category, note?}; category: fake-shop | phishing-payment | fake-carrier | other. 201 с id; дубликат в рамките на седмица → 200 с оригиналното id; лимит 20/ден → 429 |
GET /reports/{id} | статус на доклада: received | verifying | confirmed | rejected |
curl "https://dvojnik.ystvan.com/api/v1/domain?name=alza.cz"
Общо ядро
Разширението, мобилното приложение и API използват едно и също ядро (@dvojnik/core): анализ на домейна (punycode, скелет за объркващи се знаци), търсене на сходство с известни магазини, оценяване и текстове. Затова браузърът и телефонът дават еднакъв резултат.
Разширение за разработка и тестване
Разширението може да се зареди неопаковано: в Chrome/Edge на chrome://extensions включете режима за разработчици и изберете „Зареждане на неопаковано“ с папката на компилацията; във Firefox about:debugging → „Зареждане на временна добавка“. Автоматизираните тестове използват Playwright с параметър --load-extension.
Тестов режим: адрес, завършващ на .localhost, се оценява като домейна преди този суфикс (alza-vyprodej.cz.localhost → alza-vyprodej.cz), така че можете да тествате, без да посещавате истински рисков сайт.
Правила за използване на API
- Не изпращайте пълни адреси или лични данни; в бележката към доклада нищо, което идентифицира лице.
- Спазвайте ETag и кеша (s-maxage=300 при списъците) – обновяване на всеки няколко часа е достатъчно.
- При показване на списъка с блокирани посочете източника (ČOI) и формулирайте включването като рискови признаци, а не като доказателство за измама.