Für Entwickler
API v1 ist öffentlich und benötigt keinen Schlüssel. Clients senden nur den Domainnamen; Adressen mit Pfad, Schema oder Port werden abgelehnt. Antworten sind JSON in UTF‑8, Fehler { "error": "…" }.
Basis: https://dvojnik.ystvan.com/api/v1
Endpunkte
| Methode und Pfad | Beschreibung |
|---|---|
GET /health | Dienststatus, ohne Cache |
GET /blocklist | bestätigte riskante Domains: {version, count, sources[], domains:[[domain, quelle],…]}. ETag + If-None-Match → 304. Clients müssen die Quellenangabe anzeigen (sources[].attribution). |
GET /known-shops | bekannte Shops für den Ähnlichkeitsvergleich: {version, count, shops:[…]}, ETag wie oben |
GET /domain?name=beispiel.de | Blocklist-Treffer, bekannter Shop, Domain-Alter (age.status: found | not-registered | unknown) |
POST /reports | Body {domain, category, note?}; category: fake-shop | phishing-payment | fake-carrier | other. 201 mit id; Duplikat innerhalb einer Woche → 200 mit ursprünglicher id; Limit 20/Tag → 429 |
GET /reports/{id} | Meldungsstatus: received | verifying | confirmed | rejected |
curl "https://dvojnik.ystvan.com/api/v1/domain?name=alza.cz"
Gemeinsamer Kern
Erweiterung, mobile App und API nutzen denselben Kern (@dvojnik/core): Domain-Analyse (Punycode, Skelett für verwechselbare Zeichen), Ähnlichkeitssuche gegen bekannte Shops, Bewertung und Texte. Deshalb liefern Browser und Telefon dasselbe Ergebnis.
Erweiterung für Entwicklung und Tests
Die Erweiterung kann entpackt geladen werden: in Chrome/Edge unter chrome://extensions den Entwicklermodus aktivieren und „Entpackte Erweiterung laden“ mit dem Build-Ordner wählen; in Firefox about:debugging → „Temporäres Add-on laden“. Automatisierte Tests nutzen Playwright mit --load-extension.
Testmodus: eine Adresse, die auf .localhost endet, wird als die Domain vor diesem Suffix bewertet (alza-vyprodej.cz.localhost → alza-vyprodej.cz), sodass man testen kann, ohne eine echte riskante Website zu besuchen.
Regeln für die API-Nutzung
- Keine vollständigen Adressen oder personenbezogenen Daten senden; in der Notiz nichts, was eine Person identifiziert.
- ETag und Cache beachten (s-maxage=300 bei Listen) – alle paar Stunden aktualisieren genügt.
- Bei Anzeige der Blocklist die Quelle (ČOI) nennen und eine Listung als Risikomerkmale formulieren, nicht als Betrugsbeweis.