Validar un documento

POST /v1/validate genera un documento e indica lo que el servicio no admitió del todo, sin devolver el PDF y sin usar crédito. Recibe los mismos campos que la generación, salvo output.

curl -X POST https://api.example.com/v1/validate \
  -H "Authorization: Bearer $RUSTEDF_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "template_id": "0194f2c0-…", "data": { "number": "2025-0042" } }'

{
  "ok": false,
  "pages": 1,
  "diagnostics": [
    {
      "kind": "UnsupportedProperty",
      "text": "filter",
      "context": "inside <p class=\"note\">",
      "count": 2
    }
  ]
}

ok es true cuando no hay nada que informar. count indica cuántas apariciones idénticas representa una entrada. La validación cuenta en la tasa de peticiones de tu plan, como cualquier llamada.

El portal ejecuta la misma comprobación en el editor de plantillas.

Qué se informa

kind	Significado
UnsupportedTag	Un elemento HTML que el servicio no conoce.
UnsupportedProperty	Una propiedad CSS no admitida.
UnsupportedSelector	Un selector no admitido, como :hover.
UnsupportedValue	Una propiedad admitida con un valor que no se puede usar.
UnsupportedAtRule	Una at-rule como @font-face o @import.
MalformedDeclaration	Una declaración CSS que no se pudo leer.
LayoutOverflow	Una caja de tamaño fijo más alta o más ancha que la página, o contenido pintado fuera de ella.
ImageLoadFailed	Una imagen que no se pudo usar: no es un recurso tuyo, no es una URL data:, es ilegible o demasiado grande.
TextShapingFailed	Texto en una escritura que ninguna fuente disponible cubre.
VariableFontStyles	La familia es una fuente variable; solo se usa el estilo normal. Consulta Fuentes.

Ninguno interrumpe una generación por defecto. Usa strict para convertirlos en errores, por ejemplo en tus pruebas.