Buscar usuarios

`POST /user/search`

Busca usuarios en la plataforma por diferentes criterios. La busqueda prioriza contactos guardados, luego busca por username exacto, email, UUID, telefono y contactos sincronizados. Retorna un maximo de 10 resultados.

Autenticacion

Bearer Token (Authorization: Bearer {token}).

Request

curl -X POST https://api.qvapay.com/user/search \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "juan123"
  }'

Parametros

Parametro	Tipo	Requerido	Descripcion
`query`	string	Si	Termino de busqueda (username, email, UUID, telefono o nombre)

Response

[
  {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Juan",
    "lastname": "Perez",
    "username": "juan123",
    "kyc": true,
    "golden_check": false,
    "image": "profiles/uuid/avatar.webp",
    "cover": null,
    "vip": false,
    "isContact": true
  }
]

Campos de respuesta

Campo	Tipo	Descripcion
`uuid`	string	Identificador unico del usuario
`name`	string	Nombre
`lastname`	string	Apellido
`username`	string	Nombre de usuario
`kyc`	boolean	Si tiene verificacion KYC
`golden_check`	boolean	Si tiene plan GOLD
`image`	string	Ruta del avatar
`cover`	string\|null	Ruta de la portada
`vip`	boolean	Si es usuario VIP
`isContact`	boolean	Si es un contacto guardado del usuario
`isSyncedContact`	boolean	Si es un contacto sincronizado

Errores

Codigo	Descripcion
`401`	No autorizado o token invalido

POST /user/search