API

Marcar un archivo

Marca un archivo en un espacio Enterprise y descarga la copia marcada.

POST`/api/v1/mark`

Marca un archivo y devuelve la copia marcada. 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

Nombre	Tipo	Obligatorio	Descripción
file	file	Sí	El archivo que quieres marcar. Enterprise admite hasta 100 MB y 500 páginas de PDF. El tamaño y las páginas siguen el plan del espacio.
identifier	string	Sí	De 1 a 32 caracteres, sin caracteres de control. Es la etiqueta que verás si esa copia se detecta más tarde. No se escribe en el archivo como texto legible.

Solicitud

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

Respuesta

{
  "file": "JVBERi0xLjQK…",
  "mime": "application/pdf",
  "name": "contract.pdf",
  "kind": "pdf",
  "layers": [
    {
      "name": "Opaque PDF fields",
      "detail": "Three authenticated copies; no identifier text",
      "screenshot": "No",
      "crop": "No",
      "reencode": "No"
    }
  ],
  "remaining": 1
}

file son los bytes marcados en base64. mime, name y kind describen la descarga. layers lista las capas que se aplicaron. Si el plan no tiene tope de archivos activos, remaining es el número de archivos activos después de esta marca. Si tiene tope, es cuántas marcas nuevas quedan. Enterprise no tiene tope. Borrar un archivo es lo que acaba con la detección.

Errores

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

Estado	Descripción
400	El archivo está vacío, o el identificador está vacío, pasa de 32 caracteres o contiene un carácter de control.
401	La clave falta, está revocada o no se reconoce. El cuerpo JSON incluye "code": "api-key".
403	El 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.
413	El archivo supera el límite de subida del plan, o el PDF tiene más páginas de las que el plan admite.
422	No se pudo procesar el archivo.
429	Esta clave marcó más de 40 archivos en el minuto en curso.

Límite

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