En directo
Estado del servicio
Consulta el estado del servicio en directo y las respuestas de error documentadas antes de integrar la API.
Seguridad y confianza
API de security.txt
Comprueba con una sola petición si un dominio publica un security.txt válido. Recibe los campos analizados, los días hasta la caducidad, la presencia de firma y errores y advertencias codificados para máquinas.
Categoría
Seguridad y confianza
Endpoints
1
Características principales
4
Preguntas frecuentes
4
Utilizado por personas en estas empresas
Señales de confianza antes de integrar
Documentación transparente, solicitudes autenticadas y detalles visibles de fiabilidad facilitan evaluar DomScan antes de publicar.
OpenAPI
Artefactos de API
OpenAPI, Swagger, Postman, CLI, SDK y enlaces MCP están a un clic.
Claves API
Acceso protegido
Los endpoints autenticados usan claves API con costes de créditos claros antes de llamarlos.
10,000
Créditos gratuitos
Empieza con 10.000 créditos mensuales y actualiza solo cuando crezca el uso.
Qué te ayuda a lanzar esta API
Usa esta página como un resumen de producción: endpoints, ejemplos, forma de respuesta y piezas de flujo necesarias para integrar DomScan en tu producto.
Integra comprobaciones de dominios, inteligencia DNS, señales de riesgo o enriquecimiento en onboarding, búsqueda y herramientas internas.
Sustituye consultas manuales repetidas por tareas programadas, alertas y pasos de investigación reproducibles.
Usa campos previsibles, códigos de estado documentados y costes de créditos en lugar de raspar páginas de proveedores.
Alimenta agentes, paneles, playbooks SOAR y CRMs mediante OpenAPI, SDK, Postman o MCP.
Flujo de integración
Un camino simple desde la primera solicitud hasta un uso repetible en producción.
Autentica una vez
Envía tu clave API con la cabecera documentada y mantén solicitudes coherentes entre servicios.
Consulta con ejemplos
Empieza con las muestras curl y HTTP, y luego mapea los parámetros en el código de tu aplicación.
Opera y monitoriza
Usa códigos de estado, costes de créditos y campos de respuesta para crear reintentos, logs y alertas.
Kit para desarrolladores
Salta desde esta página a documentación legible por máquinas, colecciones de solicitudes, SDKs o herramientas para agentes.
Esquema OpenAPI
Genera clientes o inspecciona cada forma de solicitud y respuesta.
Colección PostmanImporta solicitudes listas para pruebas manuales y traspaso al equipo.
SDKs y CLIUsa paquetes mantenidos y flujos de línea de comandos en vez de escribir boilerplate.
Integración MCPExpón inteligencia de dominios a agentes de IA y asistentes internos.
Mapa de parámetros y respuesta
Revisa entradas, campos de salida y códigos de estado antes de conectar el endpoint a tu cliente.
Parámetro
domainurl
Respuesta de ejemplo
domainstatuslocationfieldsfields.contactfields.expiresfields.expires_in_daysfields.policysignedissues
Códigos de estado HTTP
200400401402429502
Endpoints
GET
/v1/security-txt
Señales de confianza antes de integrar
Documentación transparente, solicitudes autenticadas y detalles visibles de fiabilidad facilitan evaluar DomScan antes de publicar.
Estado del servicio
Artefactos de API
OpenAPI, Swagger, Postman, CLI, SDK y enlaces MCP están a un clic.
Claves API
Acceso protegido
Los endpoints autenticados usan claves API con costes de créditos claros antes de llamarlos.
Créditos gratuitos
Regístrate gratis
Empieza con 10.000 créditos mensuales y actualiza solo cuando crezca el uso.
Activo
Solicitud de ejemplo
Empieza con las muestras curl y HTTP, y luego mapea los parámetros en el código de tu aplicación.
Características principales
Validación según RFC 9116
Se comprueban los campos obligatorios Contact y Expires, los formatos de URI, los enlaces HTTPS, Preferred-Languages y Canonical, manteniendo separados los errores y las advertencias.
Gestión de ubicaciones
Lee primero /.well-known/security.txt y el /security.txt heredado solo después de un 404 o 410.
Supervisión de la caducidad
Devuelve la fecha de caducidad y los días restantes, para que puedas avisar antes de que expire una política de divulgación.
Cuatro estados claros
valid, invalid, not_found y unknown. Las obtenciones bloqueadas o fallidas nunca se notifican como un archivo ausente.
Solicitud de ejemplo
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/security-txt?domain=example.com"Respuesta de ejemplo
{
"domain": "example.com",
"status": "valid",
"location": "well_known",
"fields": {
"contact": ["mailto:[email protected]"],
"expires": "2027-01-01T00:00:00.000Z",
"expires_in_days": 83,
"policy": ["https://example.com/security-policy"]
},
"signed": false,
"issues": []
}Preguntas frecuentes
¿Qué hace que un archivo no sea válido?
La falta del campo Contact o Expires, varios campos Expires, una fecha vencida, URI de contacto no válidas, enlaces http sin cifrar o una página HTML servida en lugar de texto.
¿Se verifican las firmas?
Los archivos firmados se detectan y se analizan, pero la firma OpenPGP no se verifica.
¿Cuántas peticiones realiza una comprobación?
Una, o dos cuando la ubicación well-known devuelve 404 o 410 y se prueba la ubicación heredada.
¿Cuántos créditos cuesta?
Un crédito por petición. Las peticiones que terminan en estado desconocido se reembolsan.
Herramientas y recursos relacionados
Códigos de estado HTTP
Documentamos los códigos de estado HTTP que debes gestionar para distinguir respuestas correctas, problemas de autenticación o créditos, límites de frecuencia, datos inexistentes y fallos del servicio de origen.
OK
200
Solicitud correcta
Solicitud incorrecta
400
Parámetros no válidos
No autorizado
401
Clave de API o sesión ausente o no válida.
Pago requerido
402
No tienes créditos suficientes para ejecutar esta solicitud.
Demasiadas solicitudes
429
Límite de frecuencia superado
Puerta de enlace incorrecta
502
Error del servicio RDAP de origen
Comprobar un security.txt