Validação de assinaturas

POSThttps://api.zapsign.com.br/api/v1/validate-pdf-signature/

Descrição: Este endpoint realiza a validação de assinaturas digitais em arquivos PDF enviados via requisição. A verificação retorna se o documento é válido ou inválido.

Os critérios para que o documento seja considerado válido são:

• O documento possui uma ou mais assinaturas digitais

• Todas as assinaturas contidas no arquivo foram realizadas pela ZapSign

• Todas as assinaturas do arquivo são criptograficamente válidas

• O documento não foi alterado depois de ter sido assinado

• Não há assinaturas recusadas pelo assinante

• Não há assinaturas pendentes

Em caso de documento inválido, o endpoint retorna uma mensagem com a razão pela qual foi invalidado.

Como Usar:

Envie uma requisição com o método POST em formato multipart/form-data contendo o arquivo PDF no campo file .

Headers

Name	Type	Description
Content-Type	multipart/form-data

Request Body (form-data)

Name	Type	Description
file	arquivo (PDF)	Arquivo PDF a ser validado

Response Body (JSON)

Name	Type	Description
isValid	Boolean	true se arquivo é assinado válido, e false se inválido
message	Text	Mensagem refente ao resultado da validação
authority	Text	Common Name da Agência Certificadora
signingDate	Text	Data da assinatura formatada dd/mm/YYYY hh:mm:ss
commonName	Text	Common Name da assinatura (ZapSign)

Possíveis mensagens em caso de documento inválido:

Mensagem	Descrição
Signature signature1 does not cover the whole document	A assinatura não cobre o documento inteiro
Certificate validation failed: CN is not ZAPSIGN PROCESSAMENTO DE DADOS LTDA	O documento contém uma ou mais assinaturas que não foram realizadas pela ZapSign
Signature signature1 not valid because the document contains pending signature indicators	O documento é inválido porque contém indicadores de que existem assinaturas pendentes
Signature signature1 is not valid because the document contains refused signature indicators	O documento é inválido porque contem indicadores de que existem assinaturas recusadas
Document does not contain digital signatures	O documento não está assinado
Signature signature1 is not cryptographically valid	O documento contém uma assinatura inválida ou foi alterado depois de ter sido assinado

Exemplos de resposta:

Documento válido:

200: OK

{
    "isValid": true,
    "message": "Document signed correctly (CN=ZAPSIGN) and without subsequent notes.",
    "authority": "AC Certisign Multipla G7",
    "signingDate": "11/19/2024 14:34:58",
    "commonName": "ZAPSIGN PROCESSAMENTO DE DADOS LTDA"
}

Documento inválido:

200: OK

{
    "isValid": false,
    "message": "Signature Signature1 does not cover the whole document",
    "authority": "N/A",
    "signingDate": "N/A",
    "commonName": "N/A"
}