Saltar al contenido
Facturador

Subir imagen temporal (vista previa)

POST /api/items/upload-temp-image

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Recibe una imagen y la devuelve en base64 (temp_image) para mostrar una vista previa antes de guardar. Para guardar la imagen del producto envíala directamente en file de Crear o editar producto; el temp_path devuelto no se usa en ese endpoint.

Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).

Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success.

Campo Tipo Obligatorio Descripción / valores permitidos
file archivo Sí jpg, jpeg, png, svg o webp.
type string No Prefijo del archivo temporal (p. ej. items).

Errores:

  • Tipo no permitido o archivo no recibido: HTTP 200 con success: false.

Cuerpo

Content-Type: multipart/form-data

Campo Tipo Obligatorio Ejemplo Descripción
file archivo sí Imagen.
type texto sí items Prefijo del archivo temporal.

Respuestas

200 — Imagen

{
  "success": true,
  "data": {
    "filename": "gaseosa.jpg",
    "temp_path": "/tmp/itemAbC123",
    "temp_image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD..."
  }
}

200 — Tipo no permitido

{
  "success": false,
  "message": "Tipo de archivo no permitido, solo se aceptan: jpg, jpeg, png, svg, webp"
}

Pruébalo

Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.