Pular para o conteúdo principal

​
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

{
  "uuid": "h8i9j0k1-l2m3-4567-nopq-678901234567",
  "original_name": "diploma-maria-silva.pdf",
  "mime_type": "application/pdf",
  "extension": "pdf",
  "size": 245760,
  "used_at": null,
  "file": "https://storage.dokstamp.eu/files/h8i9j0k1.pdf"
}
CampoTipoDescrição
uuidstringIdentificador único — use como file_uuid ao criar certificados
original_namestringNome original do arquivo
mime_typestringTipo MIME (ex.: application/pdf)
extensionstringExtensão do arquivo
sizeintegerTamanho do arquivo em bytes
used_atdatetime|nullNulo = disponível. Não nulo = já anexado a um certificado.
filestringURL de download direto

​
Enviar arquivos

POST /files
Aceita multipart/form-data. Você pode enviar múltiplos arquivos em uma única requisição.
ParâmetroTipoObrigatórioDescrição
files[]fileSimUm ou mais arquivos PDF
# Enviar um único arquivo
curl -X POST https://api.dokstamp.eu/files \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Accept: application/json" \
  -H "X-Tenant: {TENANT}" \
  -F "files[]=@/caminho/para/diploma-maria-silva.pdf"

# Enviar múltiplos arquivos de uma vez
curl -X POST https://api.dokstamp.eu/files \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Accept: application/json" \
  -H "X-Tenant: {TENANT}" \
  -F "files[]=@diploma-1.pdf" \
  -F "files[]=@diploma-2.pdf" \
  -F "files[]=@diploma-3.pdf"
Resposta 201: 
{
  "data": [
    {
      "uuid": "h8i9j0k1-l2m3-4567-nopq-678901234567",
      "original_name": "diploma-maria-silva.pdf",
      "mime_type": "application/pdf",
      "size": 245760,
      "used_at": null
    }
  ]
}

​
Listar arquivos

GET /files
Filtrar por arquivos não utilizados (disponíveis para anexar a novos certificados): 
GET /files?where[used_at]=null

​
Obter metadados do arquivo

GET /files/{uuid}

​
Baixar um arquivo

GET /files/{uuid}/download
Este endpoint é público — nenhum cabeçalho Authorization necessário. Compartilhe esta URL diretamente com signatários, estudantes ou empregadores.
curl "https://api.dokstamp.eu/files/h8i9j0k1-l2m3-4567-nopq-678901234567/download" \
  --output diploma.pdf

​
Atualizar metadados do arquivo

PATCH /files/{uuid}
PUT   /files/{uuid}

​
Excluir um arquivo

DELETE /files/{uuid}
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.