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żka | Opis |
|---|---|
GET /health | stan usługi, bez cache |
GET /blocklist | potwierdzone 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-shops | znane sklepy do porównania podobieństwa: {version, count, shops:[…]}, ETag jak wyżej |
GET /domain?name=przyklad.pl | trafienie na liście, znany sklep, wiek domeny (age.status: found | not-registered | unknown) |
POST /reports | treść {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.