Dati web

API di idoneità per gli agenti

Verifica come i siti web pubblici espongono percorsi di individuazione, contenuti utili, politica di accesso e funzionalità per gli agenti. L'API restituisce un punteggio ponderato da 0 a 100, quattro punteggi dimensionali, prove a livello di controllo, affidabilità, etichette di maturità, avvertenze e raccomandazioni.

Consulta la documentazione Prova lo strumento gratuito Esplora tutte le API

Endpoint Attivo

GET /v1/agent-readiness

Richiesta di esempio

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

Risposta di esempio 200 OK

{
  "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"
...

Richiesta di esempio GET /v1/agent-readiness

Caratteristiche Principali 4

Domande frequenti 4

Codici di stato HTTP 200 / 400 / 401 / 402 / 429 / 502

Categoria Dati web

Endpoint 1

Caratteristiche Principali 4

Domande frequenti 4

Usato da persone di queste aziende

Segnali di fiducia prima dell’integrazione

Documentazione trasparente, richieste autenticate e dettagli di affidabilità visibili rendono più semplice valutare DomScan prima del rilascio.

In tempo reale Stato del servizio

Controlla lo stato del servizio in tempo reale e le risposte di errore documentate prima dell’integrazione.

OpenAPI Artefatti API

OpenAPI, Swagger, Postman, CLI, SDK e link MCP sono a un clic.

Chiavi API Accesso protetto

Gli endpoint autenticati usano chiavi API con costi in crediti chiari prima della chiamata.

10,000 Quota gratuita

Inizia con 10.000 crediti mensili e fai upgrade solo quando l’uso cresce.

Cosa ti aiuta a costruire questa API

Usa questa pagina come brief di produzione: endpoint, esempi, forma della risposta e parti del workflow per integrare DomScan nel tuo prodotto.

Workflow di prodotto

Integra controlli dominio, intelligence DNS, segnali di rischio o arricchimento in onboarding, ricerca e strumenti interni.

Automazione per analisti

Sostituisci lookup manuali ripetuti con job pianificati, alert e passaggi di indagine riproducibili.

Dati JSON puliti

Usa campi prevedibili, codici di stato documentati e costi in crediti invece di fare scraping di pagine provider.

AI e strumenti ops

Alimenta agenti, dashboard, playbook SOAR e CRM tramite OpenAPI, SDK, Postman o MCP.

Workflow di integrazione

Un percorso semplice dalla prima richiesta all’uso ripetibile in produzione.

Autentica una volta

Invia la tua chiave API con l’header documentato e mantieni richieste coerenti tra servizi.

Interroga con esempi

Parti dagli esempi curl e HTTP, poi mappa i parametri nel codice della tua applicazione.

Opera e monitora

Usa codici di stato, costi in crediti e campi di risposta per costruire retry, log e alert.

Kit sviluppatori

Passa da questa pagina a docs leggibili da macchina, raccolte di richieste, SDK o strumenti per agenti.

Schema OpenAPI

Genera client o ispeziona ogni forma di richiesta e risposta.

Collezione Postman

Importa richieste pronte per test manuali e handoff al team.

SDK e CLI

Usa pacchetti mantenuti e workflow da riga di comando invece di scrivere boilerplate.

Integrazione MCP

Esponi intelligence sui domini ad agenti AI e assistenti interni.

Mappa di parametri e risposta

Controlla input, campi di output e codici di stato prima di collegare l’endpoint al tuo client.

Parametri richiesta

Parametro

urldomainskip_cache

Campi risposta

Risposta di esempio

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

Copertura stati

Codici di stato HTTP

200400401402429502

Endpoint

GET /v1/agent-readiness

Crediti: 3Autenticazione: Autenticazione richiesta

Segnali di fiducia prima dell’integrazione

Documentazione trasparente, richieste autenticate e dettagli di affidabilità visibili rendono più semplice valutare DomScan prima del rilascio.

In tempo reale Stato del servizio

Controlla lo stato del servizio in tempo reale e le risposte di errore documentate prima dell’integrazione.

OpenAPI Artefatti API

OpenAPI, Swagger, Postman, CLI, SDK e link MCP sono a un clic.

Chiavi API Accesso protetto

Gli endpoint autenticati usano chiavi API con costi in crediti chiari prima della chiamata.

10,000 Quota gratuita

Inizia con 10.000 crediti mensili e fai upgrade solo quando l’uso cresce.

Caratteristiche Principali

Quattro dimensioni di idoneità

Valuta individuabilità, contenuti, politica di accesso e funzionalità in un'unica risposta.

Punteggio e affidabilità trasparenti

I controlli superati ricevono il credito completo, gli avvisi un credito parziale e i fallimenti nessun credito. I controlli sconosciuti sono esclusi dal punteggio e riducono l'affidabilità.

Prove, avvertenze e maturità

Esamina stato, peso, metodo, prove, avvertenze, riferimento ed etichetta di maturità di ogni controllo.

Audit circoscritti pronti per l'automazione

Usa punteggi e raccomandazioni coerenti nei controlli delle release, nel monitoraggio, nelle revisioni del portafoglio e nei flussi interni di qualità senza eseguire gli strumenti individuati.

Richiesta di esempio

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

Risposta di esempio

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" }
  ]
}

Domande frequenti

Che cosa restituisce l'API?

Restituisce un punteggio da 0 a 100 quando sono disponibili controlli conclusivi, quattro punteggi dimensionali, più di 35 controlli circoscritti, affidabilità, prove, avvertenze, etichette di maturità e raccomandazioni.

Come devo interpretare Sconosciuto?

Sconosciuto significa che non è stato possibile concludere un controllo sulla base delle prove disponibili. È escluso dal punteggio e riduce l'affidabilità. Non trattarlo né come superato né come fallito.

L'API esegue gli strumenti individuati?

No. Il controllo di idoneità valuta i segnali di individuazione e non richiama gli strumenti WebMCP o gli strumenti dell'applicazione individuati.

Come viene calcolato il punteggio di idoneità per gli agenti da 0 a 100?

I controlli applicabili e conclusivi vengono ponderati in base all'importanza. Un controllo superato riceve il credito completo, un avviso metà credito e un fallimento nessun credito. I controlli sconosciuti sono esclusi e riducono l'affidabilità. Il punteggio non è un ranking SEO né una garanzia di compatibilità.

Strumenti e risorse correlati

Codici di stato HTTP

Questi sono i codici di stato HTTP da gestire, per distinguere risposte riuscite, problemi di autenticazione, crediti, limiti di frequenza, dati mancanti ed errori a monte.

OK 200

Richiesta riuscita

Richiesta non valida 400

Parametri non validi

Non autorizzato 401

Chiave API o sessione mancante o non valida.

Pagamento richiesto 402

Crediti insufficienti per eseguire questa richiesta.

Troppe richieste 429

Limite di richieste superato

Gateway non valido 502

Errore RDAP upstream

Verifica l'idoneità per gli agenti

Inizia gratis Consulta la documentazione Prova lo strumento gratuito