API de compatibilité avec les agents pour les sites web

API de compatibilité avec les agents

Auditez la manière dont les sites publics exposent des chemins de découverte, du contenu utile, une politique d'accès et des fonctionnalités pour les agents. L'API renvoie un score pondéré de 0 à 100, quatre scores dimensionnels, des éléments probants pour chaque vérification, la confiance, des niveaux de maturité, des réserves et des recommandations.

{ "outcome": "complete", "summary": { "coverage": "multi_channel", "detected_signals": 2, "total_signals": 4 }, "signals": { "webmcp": { "status": "unknown", "validation": "runtime_required" }, "remote_mcp": { "status": "not_detected" }, "openapi": { "status": "detected", "validation": "confirmed" }, "llms_txt": { "status" ...

Catégorie Données web

Points de terminaison 1

Fonctionnalités clés 4

Foire aux questions 4

Utilisé par les gens des meilleures 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.

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.

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.

Workflows produit

Intégrez vérifications de domaines, intelligence DNS, signaux de risque ou enrichissement dans l’onboarding, la recherche et les outils internes.

Automatisation analyste

Remplacez les recherches manuelles répétées par des tâches planifiées, des alertes et des étapes d’enquête reproductibles.

Données JSON propres

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.

IA et opérations

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 Postman

Importez des requêtes prêtes pour les tests manuels et le transfert à l’équipe.

SDKs et CLI

Utilisez des packages maintenus et des workflows en ligne de commande au lieu d’écrire du boilerplate.

Intégration MCP

Exposez 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ètres de requête

Paramètre

urldomainskip_cache

Champs de réponse

Exemple de Réponse

outcomesummarysummary.coveragesummary.detected_signalssummary.total_signalssignalssignals.webmcpsignals.webmcp.statussignals.webmcp.validationsignals.remote_mcpsignals.remote_mcp.statussignals.openapi

Couverture des statuts

Codes de Statut HTTP

200400401402429502

Points de terminaison

GET /v1/agent-readiness

Crédits: 3Authentification: Authentification requise

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

Quatre dimensions de compatibilité

Évaluez la découverte, le contenu, la politique d'accès et les fonctionnalités dans une seule réponse.

Score et confiance transparents

Les réussites obtiennent tous les points, les avertissements des points partiels et les échecs aucun point. Les vérifications inconnues sont exclues du score et réduisent la confiance.

Éléments probants, réserves et maturité

Examinez l'état, le poids, la méthode, les éléments probants, les réserves, la référence et le niveau de maturité de chaque vérification.

Audits encadrés prêts à l'automatisation

Utilisez des scores et des recommandations cohérents dans les contrôles de mise en production, la surveillance, les revues de portefeuille et les workflows qualité internes, sans exécuter les outils découverts.

Exemple de Requête

GET /v1/agent-readiness?url=https://example.com bash

curl -G -H "X-API-Key: $DOMSCAN_API_KEY" --data-urlencode "url=https://example.com" https://domscan.net/v1/agent-readiness

Exemple de Réponse

200 OK json

{
  "outcome": "complete",
  "summary": {
    "coverage": "multi_channel",
    "detected_signals": 2,
    "total_signals": 4
  },
  "signals": {
    "webmcp": { "status": "unknown", "validation": "runtime_required" },
    "remote_mcp": { "status": "not_detected" },
    "openapi": { "status": "detected", "validation": "confirmed" },
    "llms_txt": { "status": "detected", "validation": "confirmed" }
  },
  "recommendations": [
    { "code": "ADD_WEBMCP_TOOLS", "severity": "low" }
  ]
}

Foire aux questions

Que renvoie l'API ?

Elle renvoie un score de 0 à 100 lorsque des vérifications concluantes sont disponibles, quatre scores dimensionnels, plus de 35 vérifications encadrées, la confiance, les éléments probants, les réserves, les niveaux de maturité et les recommandations.

Comment dois-je interpréter Inconnu ?

Inconnu signifie qu'une vérification n'a pas pu aboutir à partir des éléments probants disponibles. Elle est exclue du score et réduit la confiance. Ne le considérez ni comme une réussite ni comme un échec.

L'API exécute-t-elle les outils découverts ?

Non. La vérification de compatibilité évalue les signaux de découverte et n'appelle pas les outils WebMCP ni les outils d'application découverts.

Comment le score de compatibilité avec les agents de 0 à 100 est-il calculé ?

Les vérifications concluantes et applicables sont pondérées selon leur importance. Une réussite rapporte tous les points, un avertissement la moitié et un échec aucun point. Les vérifications inconnues sont exclues et réduisent la confiance. Le score n'est ni un classement SEO ni une garantie de compatibilité.

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.

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

Mauvaise passerelle 502

Erreur RDAP en amont

Vérifier la compatibilité avec les agents

Commencer gratuitement Voir la documentation Essayer l’outil gratuit