Validar um documento

POST /v1/validate gera um documento e diz o que o serviço não suportou totalmente, sem devolver o PDF e sem usar crédito. Recebe os mesmos campos da geração, exceto 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 é true quando não há nada a reportar. count diz quantas ocorrências idênticas uma entrada representa. A validação conta na taxa de requisições do seu plano, como qualquer chamada.

O portal roda a mesma verificação no editor de templates.

O que é reportado

kind	Significado
UnsupportedTag	Um elemento HTML que o serviço não conhece.
UnsupportedProperty	Uma propriedade CSS que não é suportada.
UnsupportedSelector	Um seletor que não é suportado, como :hover.
UnsupportedValue	Uma propriedade suportada com um valor que não dá para usar.
UnsupportedAtRule	Uma at-rule como @font-face ou @import.
MalformedDeclaration	Uma declaração CSS que não pôde ser lida.
LayoutOverflow	Uma caixa de tamanho fixo mais alta ou mais larga que a página, ou conteúdo pintado fora dela.
ImageLoadFailed	Uma imagem que não pôde ser usada: não é um asset seu, não é uma URL data:, está ilegível ou é grande demais.
TextShapingFailed	Texto em uma escrita que nenhuma fonte disponível cobre.
VariableFontStyles	A família é uma fonte variável; só o estilo normal é usado. Veja Fontes.

Nenhum deles interrompe uma geração por padrão. Use strict para transformá-los em erros, por exemplo nos seus testes.