User
Avatar y portada
Subir o actualizar la imagen de avatar o portada del usuario.
POST /user/avatar
Sube o actualiza la imagen de avatar o portada del usuario autenticado. La imagen se redimensiona automaticamente y se convierte a formato WebP.
Autenticacion
Bearer Token (Authorization: Bearer {token}).
Request
curl -X POST https://api.qvapay.com/user/avatar \
-H "Authorization: Bearer {token}" \
-F "[email protected]" \
-F "type=avatar"Parametros (FormData)
| Parametro | Tipo | Requerido | Descripcion |
|---|---|---|---|
file | File | Si | Archivo de imagen (JPG, JPEG o PNG) |
type | string | Si | Tipo de imagen: avatar o cover |
Restricciones
| Restriccion | Valor |
|---|---|
| Formatos aceptados | JPG, JPEG, PNG |
| Tamano maximo | 5 MB |
| Dimensiones avatar | 128 x 128 px |
| Dimensiones cover | 1088 x 256 px |
Response
{
"result": "OK",
"message": "Avatar updated successfully",
"data": {
"url": "https://media.qvapay.com/profiles/uuid/avatar-1234567890.webp",
"path": "profiles/uuid/avatar-1234567890.webp"
}
}Campos de respuesta
| Campo | Tipo | Descripcion |
|---|---|---|
result | string | Estado de la operacion |
message | string | Mensaje descriptivo |
data.url | string | URL publica de la imagen |
data.path | string | Ruta del archivo en el almacenamiento |
Errores
| Codigo | Descripcion |
|---|---|
400 | No se proporciono archivo o tipo invalido |
400 | Tipo de archivo no permitido |
400 | Archivo demasiado grande (max 5MB) |
401 | No autorizado o token invalido |
500 | Error subiendo el archivo |