API de Archivos
Lista y gestiona las cargas de archivos asociadas con tus formularios.
La API de Archivos te permite listar las cargas de archivos asociadas con tu cuenta. Los archivos se crean cuando los encuestados envían preguntas de carga de archivos o cuando subes medios (imágenes, videos) en el constructor de formularios.
Todos los cuerpos de respuesta utilizan nombres de campo en snake_case.
Listar Archivos
/api/v1/filesDevuelve una lista paginada de cargas de archivos para el usuario autenticado. Incluye tanto las cargas de medios del constructor (propiedad del usuario) como las cargas de archivos de los encuestados (asociadas con los formularios del usuario).
Parámetros de Consulta
pageintegerNúmero de página (por defecto: 1)
per_pageintegerResultados por página (por defecto: 50)
Campos de Respuesta
idstringID único de la carga de archivo
blob_urlstringURL pública para acceder al archivo
original_namestringNombre original del archivo tal como fue subido por el usuario
uuid_namestringNombre de archivo basado en UUID usado en el almacenamiento blob
sizeintegerTamaño del archivo en bytes
content_typestringTipo MIME del archivo (ej., "image/png", "application/pdf")
form_idstring or nullEl formulario con el que está asociado este archivo (para cargas de encuestados)
user_idstring or nullEl usuario que subió este archivo (para medios del constructor). null para cargas de encuestados.
created_atstringMarca de tiempo de carga en ISO 8601
Tipos de Archivo
Los archivos se dividen en dos categorías según los campos user_id y form_id:
| Categoría | user_id | form_id | Descripción |
|---|---|---|---|
| Medios del constructor | Establecido | null o establecido | Imágenes, videos o documentos subidos por ti en el constructor de formularios (ej., imágenes de preguntas, logos) |
| Cargas de encuestados | null | Establecido | Archivos enviados por los encuestados a través de preguntas de carga de archivos |
Límites de Almacenamiento
El almacenamiento de archivos se rastrea por cuenta. Puedes verificar tu uso actual a través de la API de Usuario. Los límites de almacenamiento varían según el nivel del plan. Cuando se elimina un formulario, las cargas de archivos de encuestados asociadas se limpian y el almacenamiento se recupera de forma asíncrona.
Respuesta
{
"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
}
Ejemplos de Código
curl -X GET "https://api.nueform.io/api/v1/files?page=1&per_page=20" \
-H "Authorization: Bearer YOUR_API_KEY"
Respuestas de Error
Respuestas de error estándar devueltas por este endpoint.
Códigos de Error
401UnauthorizedAPI key faltante o inválida
500Server ErrorError interno del servidor
Ejemplo de Error
{
"error": "Unauthorized"
}