QvaPay API
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)

CampoTipoRequeridoDescripción
filearchivoSíImagen JPG, PNG o WEBP. Máx 5 MB
typelogo | banner | productNo (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ódigoDescripción
400Falta el archivo, formato no permitido o supera 5 MB
401No autenticado
502No se pudo subir la imagen
500Error procesando la imagen