Développeurs

L’API v1 est publique et sans clé. Les clients n’envoient que le nom de domaine ; les adresses avec chemin, schéma ou port sont refusées. Les réponses sont en JSON UTF‑8, les erreurs { "error": "…" }.

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

Points de terminaison

Méthode et cheminDescription
GET /healthétat du service, sans cache
GET /blocklistdomaines à risque confirmés : {version, count, sources[], domains:[[domaine, source],…]}. ETag + If-None-Match → 304. Le client doit afficher l’attribution (sources[].attribution).
GET /known-shopsboutiques connues pour la comparaison de similarité : {version, count, shops:[…]}, ETag comme ci-dessus
GET /domain?name=exemple.frcorrespondance avec la liste, boutique connue, âge du domaine (age.status : found | not-registered | unknown)
POST /reportscorps {domain, category, note?} ; category : fake-shop | phishing-payment | fake-carrier | other. 201 avec id ; doublon dans la semaine → 200 avec l’id d’origine ; limite 20/jour → 429
GET /reports/{id}statut du signalement : received | verifying | confirmed | rejected
curl "https://dvojnik.ystvan.com/api/v1/domain?name=alza.cz"

Noyau partagé

L’extension, l’application mobile et l’API utilisent le même noyau (@dvojnik/core) : analyse du domaine (punycode, squelette pour les caractères confusables), recherche de similarité avec les boutiques connues, score et textes. C’est pourquoi navigateur et téléphone donnent le même résultat.

Extension pour le développement et les tests

L’extension peut être chargée non empaquetée : dans Chrome/Edge, ouvrez chrome://extensions, activez le mode développeur et choisissez « Charger l’extension non empaquetée » avec le dossier de build ; dans Firefox, about:debugging → « Charger un module temporaire ». Les tests automatisés utilisent Playwright avec --load-extension.

Mode test : une adresse se terminant par .localhost est évaluée comme le domaine précédant ce suffixe (alza-vyprodej.cz.localhost → alza-vyprodej.cz), ce qui permet de tester sans visiter un vrai site à risque.

Règles d’utilisation de l’API

  • N’envoyez pas d’adresses complètes ni de données personnelles ; rien qui identifie une personne dans la note du signalement.
  • Respectez l’ETag et le cache (s-maxage=300 pour les listes) – un rafraîchissement toutes les quelques heures suffit.
  • En affichant la liste de blocage, citez la source (ČOI) et présentez un listage comme des signes de risque, non comme une preuve de fraude.