API de Arquivos
Liste e gerencie uploads de arquivo associados aos seus formulários.
A API de Arquivos permite que você liste os uploads de arquivo associados à sua conta. Os arquivos são criados quando os respondentes enviam respostas a perguntas de upload de arquivo ou quando você faz upload de mídia (imagens, vídeos) no construtor de formulários.
Todos os corpos de resposta usam nomes de campo em snake_case.
Listar Arquivos
/api/v1/filesRetorna uma lista paginada dos uploads de arquivo do usuário autenticado. Inclui tanto os uploads de mídia do construtor (pertencentes ao usuário) quanto os uploads de arquivo de respondentes (associados aos formulários do usuário).
Parâmetros de Consulta
pageintegerNúmero da página (padrão: 1)
per_pageintegerResultados por página (padrão: 50)
Campos da Resposta
idstringID único do upload de arquivo
blob_urlstringURL pública para acessar o arquivo
original_namestringNome original do arquivo conforme enviado pelo usuário
uuid_namestringNome de arquivo baseado em UUID usado no armazenamento de blobs
sizeintegerTamanho do arquivo em bytes
content_typestringTipo MIME do arquivo (por exemplo, "image/png", "application/pdf")
form_idstring or nullO formulário ao qual este arquivo está associado (para uploads de respondentes)
user_idstring or nullO usuário que fez o upload deste arquivo (para mídia do construtor). null para uploads de respondentes.
created_atstringTimestamp ISO 8601 do upload
Tipos de Arquivo
Os arquivos se dividem em duas categorias com base nos campos user_id e form_id:
| Categoria | user_id | form_id | Descrição |
|---|---|---|---|
| Mídia do construtor | Definido | null ou definido | Imagens, vídeos ou documentos enviados por você no construtor de formulários (por exemplo, imagens de perguntas, logos) |
| Uploads de respondentes | null | Definido | Arquivos enviados por respondentes por meio de perguntas de upload de arquivo |
Limites de Armazenamento
O armazenamento de arquivos é contabilizado por conta. Você pode verificar seu uso atual via API do Usuário. Os limites de armazenamento variam conforme o nível do plano. Quando um formulário é excluído, os uploads de arquivo de respondentes associados são limpos e o armazenamento é recuperado de forma assíncrona.
Resposta
{
"files": [
{
"id": "668a1b2c3d4e5f6a7b8c9d01",
"blob_url": "https://abcdef.public.blob.vercel-storage.com/uploads/a1b2c3d4.pdf",
"original_name": "project-proposal.pdf",
"uuid_name": "a1b2c3d4.pdf",
"size": 245760,
"content_type": "application/pdf",
"form_id": "665a1b2c3d4e5f6a7b8c9d0e",
"user_id": null,
"created_at": "2026-02-25T14:30:00.000Z"
},
{
"id": "668a1b2c3d4e5f6a7b8c9d02",
"blob_url": "https://abcdef.public.blob.vercel-storage.com/uploads/e5f6a7b8.png",
"original_name": "hero-banner.png",
"uuid_name": "e5f6a7b8.png",
"size": 1048576,
"content_type": "image/png",
"form_id": null,
"user_id": "665a0a1b2c3d4e5f6a7b8c9d",
"created_at": "2026-02-20T10:15:00.000Z"
}
],
"total": 38,
"page": 1,
"per_page": 50
}
Exemplos de Código
curl -X GET "https://api.nueform.io/api/v1/files?page=1&per_page=20" \
-H "Authorization: Bearer YOUR_API_KEY"
Respostas de Erro
Respostas de erro padrão retornadas por este endpoint.
Códigos de Erro
401UnauthorizedChave de API ausente ou inválida
500Server ErrorErro interno do servidor
Exemplo de Erro
{
"error": "Unauthorized"
}