Marketplace
Imágenes
Subir logos, banners e imágenes de producto para el marketplace.
POST /market/upload
Sube una imagen y devuelve su URL pública. Úsala para obtener la URL que luego pasas en logo/banner de una tienda o main_image/images de un producto. La imagen se redimensiona y convierte a WebP automáticamente.
Autenticación
Bearer Token. La petición es multipart/form-data.
Request
curl -X POST https://api.qvapay.com/market/upload \
-H "Authorization: Bearer <token>" \
-F "file=@/ruta/a/imagen.jpg" \
-F "type=product"Parámetros (form-data)
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
file | archivo | Sí | Imagen JPG, PNG o WEBP. Máx 5 MB |
type | logo | banner | product | No (default product) | Determina el recorte: logo 512×512, banner 1600×400, product 1200×1200 |
Response 201
{
"url": "https://media.qvapay.com/market/<user-uuid>/product-1733650000000.webp",
"key": "market/<user-uuid>/product-1733650000000.webp"
}Errores
| Código | Descripción |
|---|---|
400 | Falta el archivo, formato no permitido o supera 5 MB |
401 | No autenticado |
502 | No se pudo subir la imagen |
500 | Error procesando la imagen |