Dla deweloperów

API v1 jest publiczne i nie wymaga klucza. Klienci wysyłają tylko nazwę domeny; adresy ze ścieżką, schematem lub portem są odrzucane. Odpowiedzi to JSON w UTF‑8, błędy { "error": "…" }.

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

Punkty końcowe

Metoda i ścieżkaOpis
GET /healthstan usługi, bez cache
GET /blocklistpotwierdzone ryzykowne domeny: {version, count, sources[], domains:[[domena, źródło],…]}. ETag + If-None-Match → 304. Klient musi pokazać wskazanie źródła (sources[].attribution).
GET /known-shopsznane sklepy do porównania podobieństwa: {version, count, shops:[…]}, ETag jak wyżej
GET /domain?name=przyklad.pltrafienie na liście, znany sklep, wiek domeny (age.status: found | not-registered | unknown)
POST /reportstreść {domain, category, note?}; category: fake-shop | phishing-payment | fake-carrier | other. 201 z id; duplikat w tygodniu → 200 z pierwotnym id; limit 20/dzień → 429
GET /reports/{id}status zgłoszenia: received | verifying | confirmed | rejected
curl "https://dvojnik.ystvan.com/api/v1/domain?name=alza.cz"

Wspólny rdzeń

Rozszerzenie, aplikacja mobilna i API używają tego samego rdzenia (@dvojnik/core): analiza domeny (punycode, szkielet dla mylących znaków), wyszukiwanie podobieństwa do znanych sklepów, punktacja i teksty. Dzięki temu przeglądarka i telefon dają ten sam wynik.

Rozszerzenie dla deweloperów i testów

Rozszerzenie można załadować rozpakowane: w Chrome/Edge na chrome://extensions włącz tryb dewelopera i wybierz „Załaduj rozpakowane” z folderem buildu; w Firefoksie about:debugging → „Załaduj tymczasowy dodatek”. Testy automatyczne używają Playwright z parametrem --load-extension.

Tryb testowy: adres kończący się na .localhost jest oceniany jako domena przed tym sufiksem (alza-vyprodej.cz.localhost → alza-vyprodej.cz), więc można testować bez odwiedzania prawdziwej ryzykownej strony.

Zasady korzystania z API

  • Nie wysyłaj pełnych adresów ani danych osobowych; w notatce do zgłoszenia nic, co identyfikuje osobę.
  • Szanuj ETag i cache (s-maxage=300 przy listach) – odświeżanie co kilka godzin wystarczy.
  • Pokazując listę blokowanych, podaj źródło (ČOI) i opisuj wpis jako sygnały ryzyka, nie dowód oszustwa.