Skip to main content

Ficheiros

Os ficheiros são documentos PDF enviados para o DokStamp antes de serem anexados a certificados ou documentos. Cada ficheiro só pode ser utilizado por um certificado — uma vez anexado, fica marcado como usado e não pode ser reutilizado.

O objeto ficheiro


Enviar ficheiros

Aceita multipart/form-data. É possível enviar múltiplos ficheiros numa única requisição.
Resposta 201:

Listar ficheiros

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

Obter metadados do ficheiro


Transferir um ficheiro

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

Atualizar metadados do ficheiro


Eliminar um ficheiro

Não é possível eliminar um ficheiro que já está anexado a um certificado (used_at não é nulo). Elimine ou revogue o certificado primeiro.

Deduplicação

A API calcula um hash para cada ficheiro enviado. Se o mesmo conteúdo de ficheiro for enviado duas vezes, o segundo envio devolve o registo de ficheiro existente em vez de criar um duplicado. Isto evita a acumulação desnecessária de armazenamento em fluxos de envio em lote.