API

Detectar un archivo

Comprueba un archivo contra las marcas activas de un espacio Enterprise.

POST/api/v1/detect

Comprueba un archivo en el espacio de esta clave. El cuerpo es multipart/form-data.

Autenticación

Authorization: Bearer mf_…

Envía esta cabecera. No hay cookie de sesión. curl y otros clientes de servidor se aceptan. Un navegador en otro sitio es rechazado.

Parámetros

NombreTipoObligatorioDescripción
filefileSíEl archivo que quieres comprobar. La búsqueda usa solo el espacio de esta clave. Un archivo marcado en otro espacio no se resuelve.

Solicitud

curl -X POST https://markedfile.com/api/v1/detect \
  -H "Authorization: Bearer mf_…" \
  -F "file=@leaked.pdf"

Respuesta

{
  "id": "northwind",
  "confidence": 0.9,
  "layers": [
    {
      "name": "Opaque PDF fields",
      "hit": true,
      "detail": "1 authenticated field(s) recovered",
      "screenshot": "No",
      "crop": "No",
      "reencode": "No"
    }
  ],
  "notes": [
    "Confidence is a heuristic for validated layer matches, not a measured forensic probability."
  ]
}

id es el identificador que asignaste cuando se marcó esa copia, o null si este espacio no tiene coincidencia. confidence es una heurística de las capas validadas, no una probabilidad medida. layers lista las capas, y hit es verdadero en las que coincidieron. notes describe lo que la comprobación hizo. Un archivo borrado no se resuelve.

Errores

El texto del campo error en el cuerpo JSON está en inglés.

EstadoDescripción
400El archivo está vacío.
401La clave falta, está revocada o no se reconoce. El cuerpo JSON incluye "code": "api-key".
403El espacio ya no tiene un plan Enterprise activo (el cuerpo incluye "code": "enterprise"), o el navegador envió una petición cross-site o same-site.
413El archivo supera el límite de subida del plan, o el PDF tiene más páginas de las que el plan admite.
422No se pudo procesar el archivo.
429Esta clave hizo más de 80 detecciones en el minuto en curso.

Límite

80 solicitudes por minuto para esta clave. El contador se guarda en la base de datos del producto y sobrevive a un reinicio.