За разработчици

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) и формулирайте включването като рискови признаци, а не като доказателство за измама.