Verification

Verificar se um PDF está assinado

Recebe um PDF (base64) e informa se o documento contém assinatura, listando as assinaturas encontradas. Útil para validar documentos de qualquer origem, sem necessidade de um identificador prévio.

Detecção apenas de assinaturas digitais embutidas (PAdES/CAdES, via dicionário de assinatura PKCS#7 com /ByteRange). Artefatos visuais (rubrica desenhada, carimbo, texto) não são considerados assinatura. Não extrai identidade do signatário (CPF/CNPJ), não valida cadeia de certificação ICP-Brasil nem revogação (OCSP/CRL), e não consulta registros do SignDocs — é agnóstica ao provedor.

O PDF é inspecionado em memória e descartado; nunca é armazenado.

Requer scope verification:write e credenciais de produção — chaves de sandbox/homologação recebem 403. Cada chamada consome uma unidade da cota verification.

Suporta idempotência via header X-Idempotency-Key: reenviar a mesma chave com o mesmo PDF devolve a resposta original sem consumir cota novamente.

post/v1/verify/document

Request

  • Base URL: https://api.signdocs.com.br
  • URL: https://api.signdocs.com.br/v1/verify/document
  • Auth: HTTP bearer

Headers

X-Idempotency-Keystring uuid

Chave de idempotência para evitar criação duplicada. Reenviar a mesma chave com o mesmo corpo dentro de 24h devolve a resposta original, sem consumir cota nem repetir efeitos (e-mails, webhooks). A mesma chave com um corpo diferente responde 409.

A resposta repetida é a original byte a byte, incluindo os cabeçalhos RateLimit-* — eles refletem a cota no momento da chamada original, já que a repetição não consumiu nada.

Request body

contentstring byte required

Conteúdo do PDF em base64 (máximo 10 MB).

filenamestring

Nome opcional do arquivo (apenas informativo).

Response

Documento inspecionado com sucesso.

signedboolean required

true se ao menos uma assinatura foi detectada.

signatureCountinteger required

Quantidade de assinaturas detectadas.

checkedAtstring date-time required

Momento da verificação (UTC ISO 8601).

Example response

{
  "signatures": [
    {
      "method": "pades_signature",
      "subFilter": "ETSI.CAdES.detached",
      "filter": "Adobe.PPKLite"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.