veraPDF como API: validaciones PDF/UA por 10 créditos

Una validación PDF/UA cuesta 10 créditos. veraPDF valida el PDF contra PDF/UA-1 o PDF/UA-2, la norma ISO del PDF accesible, y devuelve su informe completo: si el archivo es conforme, y cada regla que incumple con los objetos que la incumplen. Una validación PDF/A cuesta 2 créditos, y una WTPDF 10.

La API es la de veraPDF REST. Un cliente escrito para veraPDF REST conserva sus rutas y su analizador de informes; cambia la URL base a https://api.pagespool.com/v1/verapdf y envía una clave de API.

Qué valida veraPDF

veraPDF es el validador de PDF de código abierto de un consorcio liderado por la Open Preservation Foundation y la PDF Association. Valida:

• PDF/UA-1 y PDF/UA-2 (ISO 14289), para la accesibilidad: etiquetas y estructura, texto alternativo en las figuras, fuentes, idioma y metadatos;
• WTPDF 1.0, Accessibility y Reuse;
• PDF/A, la norma ISO para el archivo: las partes 1, 2 y 3 en los niveles a, b y u (la parte 1 no tiene u), y la parte 4 con e y f. El perfil auto valida contra la parte que el archivo declara en sus metadatos, y contra PDF/A-1b cuando no declara ninguna.

veraPDF valida las reglas que una máquina puede comprobar. Pasar la validación PDF/UA no significa que el texto alternativo o el orden de lectura tengan sentido; eso sigue necesitando a una persona.

Precios y límites

Una llamada que falla no cuesta nada. Cada llamada acepta un PDF de hasta 25 MB, enviado como campo multipart file. Una validación dura como máximo 50 segundos; una más larga se detiene con un 504. Cada cuenta recibe créditos gratis cada día y cada mes, y los planes están en la página de precios.

Alojar veraPDF tú o llamarlo aquí

veraPDF REST es un servidor Java. Alojarlo tú significa una JVM con alrededor de 1 GB de memoria por instancia, siempre en marcha y actualizada. No tiene autenticación propia, así que necesita delante una pasarela con TLS y claves antes de que nada fuera de tu red pueda llamarlo. Una JVM en frío también tarda decenas de segundos en sus primeras validaciones tras cada arranque, así que hay que calentarla antes de que reciba tráfico.

Aquí es una clave de API y la misma API. veraPDF funciona en caliente, una validación solo se cobra cuando sale bien, y la misma clave y el mismo saldo de créditos sirven para los demás motores de este sitio.

Inicio rápido con curl

Valida un PDF contra PDF/UA-1 e imprime el resultado:

curl -sS -H "X-API-Key: $API_KEY" -H "Accept: application/json" \
  -F file=@document.pdf \
  https://api.pagespool.com/v1/verapdf/api/validate/ua1 \
  | jq '.report.jobs[0].validationResult[0].compliant'

Accept elige el formato del informe: application/xml para XML, text/html para HTML, JSON para cualquier otro. Las reglas incumplidas están en .report.jobs[0].validationResult[0].details.ruleSummaries. Una validación PDF/A es la misma llamada con un perfil PDF/A, como validate/2b.

Tu cliente de veraPDF REST, sin cambios

Apunta el cliente a https://api.pagespool.com/v1/verapdf donde tenía la raíz de veraPDF REST, como http://localhost:8080. Las rutas no cambian:

• POST /api/validate/{profile} con el PDF como campo multipart file;
• GET /api/profiles, GET /api/profiles/{id} (ids lista los ids de perfil);
• GET /api/info.

Un cliente que solo acepta una URL base lleva la clave en ella: https://x:YOUR_API_KEY@ seguido del host de la API y /v1/verapdf. Hay cuatro diferencias con un servidor propio: una solicitud sin Accept recibe JSON, donde veraPDF REST responde HTML; /api/info omite la dirección y el nombre de host del servidor; POST /api/validate/url/{profile} y /api/sha1 no se ofrecen; y un archivo que no es un PDF se rechaza con un 422 antes de validarlo.

Tu clave de API, de tres formas

Envía la clave de la forma que admita tu cliente:

• la cabecera X-API-Key: YOUR_API_KEY;
• la cabecera Authorization: Bearer YOUR_API_KEY;
• autenticación HTTP Basic con la clave como contraseña y cualquier nombre de usuario, que es lo que envía un cliente HTTP para una URL con la clave dentro, https://x:YOUR_API_KEY@….

No pongas nunca la clave en una ruta ni en una query string: ambas acaban en los registros. Una llamada sin una clave válida recibe un 401.

Herramientas gratuitas y MCP

Prueba una validación en el navegador, sin cuenta: el comprobador de accesibilidad PDF (PDF/UA) y el validador PDF/A, para PDF de hasta 4 MB.

Los agentes de IA llegan a veraPDF por su servidor MCP en https://api.pagespool.com/mcp/verapdf/. Tiene dos herramientas: check_pdf_accessibility (PDF/UA, 10 créditos) y validate_pdfa (2 créditos), y cada una devuelve el resultado y las reglas incumplidas. En Conectar están los pasos para cada cliente.

Marcas

veraPDF es una marca de su titular; pagespool no está afiliado a él.

Preguntas frecuentes

¿Puedo seguir usando mi cliente de veraPDF REST?

Sí. Cambia su URL base a /v1/verapdf en el host de la API y envía tu clave de API. Las rutas, los ids de perfil, el campo multipart file y el informe siguen como los tiene veraPDF REST.

¿Cuánto cuesta una validación?

Una validación PDF/UA o WTPDF cuesta 10 créditos, una PDF/A 2. Consultar los perfiles y la información del servidor es gratis, y una llamada que falla no cuesta nada.

¿Pasar la validación PDF/UA significa que el PDF es accesible?

Significa que el PDF cumple todas las reglas que veraPDF puede comprobar a máquina. Si el texto alternativo y el orden de lectura tienen sentido sigue necesitando a una persona.

¿Se guarda mi PDF?

No. El PDF se conserva solo mientras veraPDF lo valida, y no se guarda después.