API para empresas
El veredicto de Comprobar, dentro de tu app
Para bancos, operadoras, aseguradoras y apps: tu cliente te reenvía un SMS, un WhatsApp o un correo dudoso y tu app le responde al momento si tiene señales de estafa, por qué y qué hacer. Un texto entra; un veredicto sale. No guardamos nada.
Cómo funciona
Una llamada desde tu servidor (nunca desde el navegador ni desde la app del cliente), con tu clave en la cabecera:
POST /v1/comprobar
Authorization: Bearer <tu clave>
Content-Type: application/json
{"texto": "Correos: su paquete está retenido. Pague 1,99 € en https://correos-envio.top/pago", "ia": false, "enlaces": false}
Respuesta:
{
"nivel": "estafa",
"titulo": "Tiene todas las señales de una estafa",
"motivos": ["El dominio imita a Correos pero no es su dominio oficial.", "…"],
"consejos": ["No pinches el enlace ni metas datos en esa web.", "…"],
"enlaces": [{"host": "correos-envio.top", "official": false, "brand": "Correos", "age_days": 3}],
"iban": [],
"ia": false,
"version": "0.45.0"
}
- nivel: «sin_senales», «sospechoso» o «estafa». Los motivos y consejos están en castellano, listos para enseñar.
- ia: si lo pides, se añade la segunda opinión de inteligencia artificial, que nunca rebaja una alerta de las reglas.
- enlaces: si lo pides, abrimos los enlaces del texto para valorarlos. Por defecto no se abren: abrir el enlace personalizado de un mensaje puede avisar al estafador de que alguien lo ha pinchado.
- Los IBAN se devuelven abreviados, con su banco o su país; si el texto trae el resultado de la verificación del beneficiario del banco, se explica en «verificacion_beneficiario».
Límites y respuestas
- Hasta 60 consultas por minuto y 20.000 al día por clave; podemos ampliarlo en el contrato.
- Textos de hasta 20.000 caracteres.
- 401 sin clave o con una clave no válida; 413 si el texto es demasiado largo; 429 si se agota el cupo, con la cabecera Retry-After.
Privacidad
- Actuamos como encargado del tratamiento de tu empresa: el contrato incluye el contrato de encargo (art. 28 del RGPD).
- El texto se analiza en memoria en nuestro servidor de la Unión Europea y se descarta. No entra en el radar, ni en las oleadas, ni en ningún registro. Solo contamos cuántas consultas hace cada clave.
- Por defecto, nada sale de nuestro servidor salvo los nombres de dominio, que se consultan en los servicios públicos de DNS y de registro de dominios. Si pides «enlaces», abrimos los enlaces del texto (las webs enlazadas reciben esa visita) y, si está activa, consultamos la dirección en una lista de webs peligrosas de un proveedor de seguridad. Si pides «ia», el texto va a nuestro proveedor de inteligencia artificial, que no lo conserva ni lo usa para entrenar. Todos figuran en el contrato de encargo.
- Tu clave se entrega una sola vez; nosotros solo guardamos su huella.