GET
https://api.myidvirtual.com
/
user
/
{id}
Obter Usuário
curl --request GET \
  --url https://api.myidvirtual.com/user/{id} \
  --header 'Authorization: <authorization>'
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "email": "[email protected]",
  "name": "João Silva",
  "nickname": "joao",
  "role": "CUSTOMER",
  "language": "pt-BR",
  "cellphone": "+5511999999999",
  "credits": 150,
  "status": true,
  "isAppManager": false,
  "first_recharge": true,
  "gender": "MASCULINO",
  "birthday": "1990-01-15T00:00:00.000Z",
  "latitude": -23.5505199,
  "longitude": -46.6333094,
  "avatar": "https://api.exemplo.com/avatars/123.jpg",
  "notes": "Cliente premium",
  "mac_address": "00:1B:44:11:3A:B7",
  "sub_partner_id": "partner_123",
  "yapi_id": "yapi_456",
  "bpix_pk": "pix_key_789",
  "owner": "admin_user_id",
  "myMaster": "master_user_id",
  "myAdmin": "admin_user_id",
  "isSupplier": false,
  "autopay_payment": true,
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-20T14:25:00.000Z"
}

​
Obter Usuário

Endpoint para obter informações detalhadas de um usuário específico através do seu ID único.

​
Autenticação

​
Authorization
string
required
Bearer token JWT do usuário autenticado

​
Parâmetros

​
Path Parameters

​
id
string
required
ID único do usuário a ser consultado

​
Responses

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "email": "[email protected]",
  "name": "João Silva",
  "nickname": "joao",
  "role": "CUSTOMER",
  "language": "pt-BR",
  "cellphone": "+5511999999999",
  "credits": 150,
  "status": true,
  "isAppManager": false,
  "first_recharge": true,
  "gender": "MASCULINO",
  "birthday": "1990-01-15T00:00:00.000Z",
  "latitude": -23.5505199,
  "longitude": -46.6333094,
  "avatar": "https://api.exemplo.com/avatars/123.jpg",
  "notes": "Cliente premium",
  "mac_address": "00:1B:44:11:3A:B7",
  "sub_partner_id": "partner_123",
  "yapi_id": "yapi_456",
  "bpix_pk": "pix_key_789",
  "owner": "admin_user_id",
  "myMaster": "master_user_id",
  "myAdmin": "admin_user_id",
  "isSupplier": false,
  "autopay_payment": true,
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-20T14:25:00.000Z"
}

​
Exemplo de Requisição

curl --location --request GET 'http://localhost:3333/user/123e4567-e89b-12d3-a456-426614174000' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

​
Controle de Acesso

​
Regras de Visualização

Papel do SolicitantePode Ver
ADMINTodos os usuários
MASTERPróprios subordinados + revendedores
RESALEApenas próprios clientes
CUSTOMERApenas próprio perfil

​
Campos Sensíveis

Alguns campos podem ser omitidos baseado no nível de acesso:
  • bpix_pk - Apenas admin/proprietário
  • notes - Apenas admin/master
  • mac_address - Apenas admin/técnico

​
Hierarquia de Usuários

​
Estrutura

ADMIN (Sistema)
└── MASTER (Supervisores)
    └── RESALE (Revendedores)
        └── CUSTOMER (Clientes)

​
Campos de Hierarquia

  • owner: Quem criou o usuário
  • myMaster: Master responsável
  • myAdmin: Admin supervisor
Usuários só podem visualizar perfis dentro de sua hierarquia ou próprio perfil, conforme regras de acesso.
Use este endpoint para implementar sistemas de perfil, auditoria e suporte técnico.

​
Próximos Passos

  1. Implemente cache local para perfis acessados frequentemente
  2. Configure logs de acesso para auditoria
  3. Crie interface responsiva para diferentes dispositivos
  4. Implemente edição inline para campos permitidos
Este endpoint é essencial para sistemas de CRM, suporte técnico e gerenciamento de hierarquia de usuários.