Skip to main content

Arquivos

Arquivos são documentos PDF enviados ao DokStamp antes de serem anexados a certificados ou documentos. Cada arquivo só pode ser usado por um certificado — uma vez anexado, ele é marcado como usado e não pode ser reutilizado.

O objeto arquivo


Enviar arquivos

Aceita multipart/form-data. Você pode enviar múltiplos arquivos em uma única requisição.
Resposta 201:

Listar arquivos

Filtrar por arquivos não utilizados (disponíveis para anexar a novos certificados):

Obter metadados do arquivo


Baixar um arquivo

Este endpoint é público — nenhum cabeçalho Authorization necessário. Compartilhe esta URL diretamente com signatários, estudantes ou empregadores.

Atualizar metadados do arquivo


Excluir um arquivo

Você não pode excluir um arquivo que já está anexado a um certificado (used_at não é nulo). Exclua ou revogue o certificado primeiro.

Deduplicação

A API calcula um hash para cada arquivo enviado. Se você enviar o mesmo conteúdo de arquivo duas vezes, o segundo envio retorna o registro de arquivo existente em vez de criar um duplicado. Isso evita o acúmulo desnecessário de armazenamento em fluxos de envio em lote.