Vérifiez l’état du service en direct et les réponses d’échec documentées avant de procéder à l’intégration.
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, Swagger, Postman, CLI, SDK et liens MCP sont accessibles en un clic.
Les endpoints authentifiés utilisent des clés API avec des coûts en crédits clairs avant l’appel.
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.
Envoyez votre clé API avec l’en-tête documenté et gardez des requêtes cohérentes entre services.
Commencez par les exemples curl et HTTP, puis mappez les paramètres dans le code de votre application.
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.
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
Exemple de Réponse
Codes de Statut HTTP
Points de terminaison
/v1/identity-assets
/v1/identity-assets/bulk
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, Swagger, Postman, CLI, SDK et liens MCP sont accessibles en un clic.
Les endpoints authentifiés utilisent des clés API avec des coûts en crédits clairs avant l’appel.
Commencez avec 10 000 crédits mensuels et passez à l’offre supérieure seulement quand l’usage augmente.
Commencez par les exemples curl et HTTP, puis mappez les paramètres dans le code de votre application.
Fonctionnalités clés
Trouvez les logos candidats déclarés dans les données structurées et les métadonnées publiques du site web.
Extrayez les favicons, les icônes Apple Touch, les icônes de masque et les références du manifeste web.
Renvoyez les images d’aperçu Open Graph et les couleurs de thème déclarées avec les ressources d’identité.
Chaque candidat précise la source, le type de ressource, le type MIME et la taille déclarée lorsqu’ils sont disponibles.
Inclut les profils publics normalisés liés par le site web, avec leur source et leur niveau de confiance.
Traitez jusqu’à 10 domaines dans une requête, avec des résultats ordonnés et des erreurs par élément.
Exemple de Requête
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/identity-assets?domain=example.com"
curl -X POST -H "X-API-Key: $DOMSCAN_API_KEY" -H "Content-Type: application/json" \
-d '{"domains":["example.com","github.com"]}' https://domscan.net/v1/identity-assets/bulk
Exemple de Réponse
{
"domain": "example.com",
"organization_name": "Example",
"assets": {
"logo_url": "https://example.com/logo.svg",
"favicon_url": "https://example.com/favicon.ico",
"theme_color": "#111827",
"candidates": []
},
"confidence": 0.8,
"evidence": ["organization_name", "structured_logo", "declared_icon"]
}
Foire aux questions
DomScan donne la priorité aux logos explicitement déclarés dans les données structurées de type Organization et conserve les autres icônes et images d’aperçu du site comme candidats distincts.
Un logo représente l’organisation, tandis qu’un favicon est une petite icône de site web. L’API les présente séparément afin que votre application puisse choisir la ressource adaptée.
Non. L’API renvoie les URL d’origine des ressources publiques et leur provenance. Votre application reste responsable de l’utilisation autorisée, de la mise en cache et de la présentation.
Le champ logo reste à null. D’autres icônes ou images d’aperçu déclarées peuvent apparaître comme candidats distincts sans être désignées à tort comme des logos.
Oui. Envoyez jusqu’à 10 domaines au point de terminaison groupé. Les résultats conservent l’ordre d’entrée et les échecs individuels ne masquent pas les éléments traités avec succès.
Outils et Ressources Connexes
Codes de Statut HTTP
Nous documentons les codes d'état HTTP que votre client doit 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.
Requête réussie
Paramètres invalides
Clé API ou session manquante ou invalide.
Crédits insuffisants pour exécuter cette requête.
Limite de débit dépassée
Erreur interne
Erreur RDAP en amont
Le service amont est indisponible ou limite temporairement les requêtes.
La requête amont a expiré.
Créez avec les Données d’Identité Web