En direct
État du service
Vérifiez l’état du service en direct et les réponses d’échec documentées avant de procéder à l’intégration.
Sécurité et confiance
API d’analyse IDN et homographes
Analysez un nom de domaine internationalisé en une seule requête. Obtenez les formes Unicode et Punycode, les écritures par label, les caractères trompeurs, un squelette de confusion et un niveau de risque.
Catégorie
Sécurité et confiance
Points de terminaison
1
Fonctionnalités clés
4
Questions fréquentes
4
Utilisé par des équipes de ces entreprises
Signaux de confiance avant intégration
Une documentation transparente, des requêtes authentifiées et des détails de fiabilité visibles facilitent l’évaluation de DomScan avant mise en production.
OpenAPI
Artefacts API
OpenAPI, Swagger, Postman, CLI, SDK et liens MCP sont accessibles en un clic.
Clés API
Accès protégé
Les endpoints authentifiés utilisent des clés API avec des coûts en crédits clairs avant l’appel.
10,000
Quota gratuit
Commencez avec 10 000 crédits mensuels et passez à l’offre supérieure seulement quand l’usage augmente.
Ce que cette API vous aide à livrer
Utilisez cette page comme brief de production : endpoints, exemples, structure de réponse et éléments de workflow pour intégrer DomScan à votre produit.
Intégrez vérifications de domaines, intelligence DNS, signaux de risque ou enrichissement dans l’onboarding, la recherche et les outils internes.
Remplacez les recherches manuelles répétées par des tâches planifiées, des alertes et des étapes d’enquête reproductibles.
Utilisez des champs prévisibles, des codes d’état documentés et des coûts en crédits au lieu de scraper des pages fournisseur.
Alimentez agents, tableaux de bord, playbooks SOAR et CRMs via OpenAPI, SDK, Postman ou MCP.
Flux d’intégration
Un parcours simple de la première requête à un usage répétable en production.
Authentifier une fois
Envoyez votre clé API avec l’en-tête documenté et gardez des requêtes cohérentes entre services.
Interroger avec les exemples
Commencez par les exemples curl et HTTP, puis mappez les paramètres dans le code de votre application.
Exploiter et surveiller
Utilisez codes d’état, coûts en crédits et champs de réponse pour construire retries, logs et alertes.
Kit développeur
Passez de cette page aux docs lisibles par machine, collections de requêtes, SDKs ou outils d’agents.
Schéma OpenAPI
Générez des clients ou inspectez chaque forme de requête et de réponse.
Collection PostmanImportez des requêtes prêtes pour les tests manuels et le transfert à l’équipe.
SDKs et CLIUtilisez des packages maintenus et des workflows en ligne de commande au lieu d’écrire du boilerplate.
Intégration MCPExposez l’intelligence de domaines aux agents IA et aux assistants internes.
Carte des paramètres et réponses
Parcourez les entrées, champs de sortie et codes d’état avant de connecter l’endpoint à votre client.
Paramètre
domain
Exemple de réponse
unicodeasciiis_idnvalidskeletonriskrisk.levelrisk.reasons
Codes de statut HTTP
200400401402429
Points de terminaison
GET
/v1/idn
Signaux de confiance avant intégration
Une documentation transparente, des requêtes authentifiées et des détails de fiabilité visibles facilitent l’évaluation de DomScan avant mise en production.
État du service
Artefacts API
OpenAPI, Swagger, Postman, CLI, SDK et liens MCP sont accessibles en un clic.
Clés API
Accès protégé
Les endpoints authentifiés utilisent des clés API avec des coûts en crédits clairs avant l’appel.
Quota gratuit
Inscrivez-vous gratuitement
Commencez avec 10 000 crédits mensuels et passez à l’offre supérieure seulement quand l’usage augmente.
Actif
Exemple de requête
Commencez par les exemples curl et HTTP, puis mappez les paramètres dans le code de votre application.
Fonctionnalités clés
Conversion UTS 46
Convertit Unicode et Punycode dans les deux sens et vérifie les limites de longueur des labels et du nom.
Contrôles des écritures et des caractères
Liste les écritures de chaque label, signale les labels à écritures mixtes hors combinaisons CJK autorisées et détecte les caractères invisibles.
Squelette de confusion
Associe les caractères cyrilliques, grecs, arméniens et pleine chasse trompeurs à leur apparence latine, pour comparer un nom à la marque qu’il imite.
Aucun appel réseau
L’analyse s’exécute entièrement sur DomScan : les résultats sont instantanés et identiques pour une même entrée.
Exemple de requête
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/idn?domain=xn--80ak6aa92e.com"Exemple de réponse
{
"unicode": "аррӏе.com",
"ascii": "xn--80ak6aa92e.com",
"is_idn": true,
"valid": true,
"skeleton": "apple.com",
"risk": { "level": "high", "reasons": ["idn_label", "whole_script_confusable"] }
}Questions fréquentes
Quand le risque est-il élevé ?
Lorsqu’un label mélange le latin avec le cyrillique, le grec ou l’arménien, lorsqu’un label non latin se lit entièrement comme des lettres latines, ou lorsqu’il contient des caractères invisibles.
La liste complète des caractères confondables d’Unicode est-elle utilisée ?
Non. Un sous-ensemble sélectionné des sosies les plus courants est utilisé, et chaque réponse le précise : un résultat à faible risque n’est donc pas une preuve de sécurité.
Puis-je envoyer du Punycode ?
Oui. Envoyez l’une ou l’autre forme et les deux sont renvoyées, avec l’indication de savoir si chaque label est un IDN.
Combien de crédits cela coûte-t-il ?
Un crédit par requête.
Outils et ressources associés
Codes de statut HTTP
Voici les codes d'état HTTP à gérer, afin de distinguer les réponses réussies, les problèmes d'authentification, les crédits, les limites de débit, les données introuvables et les erreurs en amont.
OK
200
Requête réussie
Requête incorrecte
400
Paramètres invalides
Non autorisé
401
Clé API ou session manquante ou invalide.
Paiement requis
402
Crédits insuffisants pour exécuter cette requête.
Trop de requêtes
429
Limite de débit dépassée
Analyser un domaine