Signing

Preparar assinatura digital

Prepara o documento para assinatura digital com certificado ICP-Brasil A1. Retorna o hash que deve ser assinado pelo certificado do cliente.

O cliente deve enviar a cadeia de certificados PEM para que o servidor prepare o placeholder no PDF (para documentos PDF) ou compute o hash do arquivo inteiro (para documentos genéricos — CAdES .p7s com conteúdo anexado).

O formato é determinado automaticamente pelo documentFormat da transação, definido no momento do upload do documento.

Requer scope transactions:write.

post/v1/transactions/{transactionId}/signing/prepare

Request

  • Base URL: https://api.signdocs.com.br
  • URL: https://api.signdocs.com.br/v1/transactions/{transactionId}/signing/prepare
  • Auth: HTTP bearer

Path parameters

transactionIdstring required

Identificador único da transação.

Request body

certificateChainPemsstring[] required

Cadeia de certificados PEM do signatário (certificado do signatário primeiro).

Response

Hash para assinatura gerado com sucesso.

signatureRequestIdstring required

Identificador da requisição de assinatura.

hashToSignstring required

Hash que deve ser assinado pelo certificado A1 do cliente.

hashAlgorithm'SHA-256' required

Algoritmo de hash utilizado.

signatureAlgorithm'RSASSA-PKCS1-v1_5' required

Algoritmo de assinatura esperado.

Changes

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