API UniValidar

X-API-Key: uvt_seu_token_aqui
# ou
Authorization: Bearer uvt_seu_token_aqui

curl -X POST "{{BASE}}/validar" \
  -H "X-API-Key: $TOKEN" \
  -F "file=@procuracao.pdf"

import httpx

TOKEN = "uvt_..."

with open("procuracao.pdf", "rb") as f:
    r = httpx.post(
        "{{BASE}}/validar",
        headers={"X-API-Key": TOKEN},
        files={"file": ("procuracao.pdf", f, "application/pdf")},
        timeout=180,
    )

dados = r.json()
if not dados["sucesso"]:
    print(dados["codigo"], dados["erro"])
else:
    print(dados["status_label"])
    for a in dados["assinaturas"]:
        print(a["nome"], a["cpf"], a["status"])

import { readFile } from "node:fs/promises";

const form = new FormData();
form.append("file", new Blob([await readFile("procuracao.pdf")], { type: "application/pdf" }), "procuracao.pdf");

const r = await fetch("{{BASE}}/validar", {
  method: "POST",
  headers: { "X-API-Key": process.env.TOKEN },
  body: form,
  signal: AbortSignal.timeout(180_000),
});
const dados = await r.json();
if (!dados.sucesso) throw new Error(`${dados.codigo}: ${dados.erro}`);
console.log(dados.status_label, dados.assinaturas);

<?php
$ch = curl_init('{{BASE}}/validar');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['X-API-Key: ' . getenv('TOKEN')],
    CURLOPT_POSTFIELDS     => ['file' => new CURLFile('procuracao.pdf', 'application/pdf')],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 180,
]);
$dados = json_decode(curl_exec($ch), true);
curl_close($ch);

if (!$dados['sucesso']) {
    echo $dados['codigo'] . ': ' . $dados['erro'];
} elseif ($dados['valido']) {
    echo 'Assinatura aprovada';
}

{
  "id": 1532,
  "sucesso": true,
  "valido": true,
  "status": "aprovada",
  "status_label": "Assinatura aprovada",
  "total_assinaturas": 1,
  "assinaturas": [
    {
      "nome": "FULANO DE TAL",
      "cpf": "***.123.456-**",
      "autoridade": "ICP-Brasil",
      "data": "16/10/2026 15:34:16 BRT",
      "status": "aprovada",
      "status_texto": "Assinatura aprovada",
      "tipo_assinatura": "Destacada",
      "motivo": "ASSINA POR PROCURAÇÃO",
      "certificado": {
        "tipo": "RFB e-CPF A1",
        "emissor": "AC SAFEWEB RFB v5",
        "valido_de": "04/03/2026 11:39:48 BRT",
        "valido_ate": "04/03/2027 11:39:48 BRT",
        "numero_serie": "0x44f3...",
        "revogado": false,
        "expirado": false
      },
      "cadeia_certificados": ["FULANO DE TAL", "AC SAFEWEB RFB v5", "AC Secretaria da Receita Federal do Brasil v4", "Autoridade Certificadora Raiz Brasileira v5"],
      "cadeia_valida": true,
      "integridade_ok": true,
      "carimbos_tempo": [{ "emissor": "SAFEWEB 50160", "referencia": "16/10/2026 15:34:32 BRT", "status": "aprovada" }],
      "algoritmo": "RSA",
      "alertas": []
    }
  ],
  "documento": {
    "nome": "procuracao.pdf",
    "hash": "70562c78d196...a163859",
    "tipo_arquivo": "PDF",
    "data_validacao": "17/10/2026 20:07:27 BRT",
    "conformidade": "MP 2.200-2/2001"
  },
  "arquivo": { "nome": "procuracao.pdf", "tamanho_bytes": 669924, "sha256": "70562c78d196...a163859" },
  "tempo_ms": 6230,
  "cache": false,
  "relatorio_conformidade": { "disponivel": true, "tamanho_bytes": 48211, "baixar": "/validacoes/1532/relatorio-conformidade" },
  "relatorio_conformidade_base64": "JVBERi0xLjQKJ...",
  "relatorio_texto": "Informações gerais do arquivo: ..."
}

import base64

if dados["relatorio_conformidade"]["disponivel"]:
    with open(f"relatorio-{dados['id']}.pdf", "wb") as saida:
        saida.write(base64.b64decode(dados["relatorio_conformidade_base64"]))

import { writeFile } from "node:fs/promises";

if (dados.relatorio_conformidade?.disponivel) {
  await writeFile(`relatorio-${dados.id}.pdf`, Buffer.from(dados.relatorio_conformidade_base64, "base64"));
}

if ($dados['relatorio_conformidade']['disponivel']) {
    file_put_contents("relatorio-{$dados['id']}.pdf", base64_decode($dados['relatorio_conformidade_base64']));
}

curl -H "X-API-Key: $TOKEN" -o selo-assinatura.png \
  "{{BASE}}/validacoes/1532/selos/assinatura-1.png"

for selo in dados["selos"]:
    png = requests.get(BASE + selo["png"], headers=CAB, timeout=30).content
    open(f"{selo['nome']}.png", "wb").write(png)

curl -X POST "{{BASE}}/validar/url" \
  -H "X-API-Key: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://exemplo.com.br/documento.pdf"}'

curl -X POST "{{BASE}}/validar/lote?relatorio_conformidade=false" \
  -H "X-API-Key: $TOKEN" \
  -F "files=@contrato.pdf" \
  -F "files=@procuracao.pdf"

{
  "total": 2,
  "aprovadas": 1,
  "com_erro": 0,
  "resultados": [ { "id": 1533, "status": "aprovada", ... }, { "id": 1534, "status": "reprovada", ... } ]
}

curl -H "X-API-Key: $TOKEN" "{{BASE}}/validacoes/1532"

curl -H "X-API-Key: $TOKEN" -o relatorio.pdf \
  "{{BASE}}/validacoes/1532/relatorio-conformidade"

{
  "nome": "Sistema de Procurações",
  "limite_dia": 500, "usado_dia": 37, "restante_dia": 463,
  "limite_mes": null, "usado_mes": 0, "restante_mes": null
}

{
  "sucesso": false,
  "codigo": "COTA_ESGOTADA",
  "erro": "Limite diário atingido (500 validações)"
}

{ "ok": true, "produto": "UniValidar", "versao": "3.0.0" }