Consultar carteira por ID

Este endpoint permite obter os detalhes de uma carteira específica pelo seu ID.

⚠️ IMPORTANTE - Regras Obrigatórias

🚨 AUTENTICAÇÃO: Todas as requisições DEVEM incluir um token JWT válido

📊 ID VÁLIDO: O ID da carteira deve ser válido e existir no sistema

📍 Endpoint

GET https://api.etherglobalassets.com.br/criptobrokers/v1/wallet/{id}

🧾 Cabeçalhos obrigatórios (Headers)

Cabeçalho	Valor	Descrição
Authorization	Bearer <token>	Token JWT de autenticação

🧰 Parâmetros de Caminho (Path Parameters)

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
id	string	✅	ID da carteira	`wallet_123456789abcdef`

📌 Exemplo com curl

curl https://api.etherglobalassets.com.br/criptobrokers/v1/wallet/wallet_123456789abcdef \
  --request GET \
  --header 'Authorization: Bearer <token>'

✅ Dica: Substitua <token> pelo seu JWT de autenticação válido e <id> pelo ID da carteira.

✅ Resposta esperada (HTTP 200 - OK)

{
  "id": "wallet_123456789abcdef",
  "network": "mainnet",
  "blockchain": "ethereum",
  "type": "CUSTOMER",
  "address": "0xabcdef1234567890abcdef1234567890abcdef12",
  "label": "CUSTOMER-ETHEREUM-MAINNET-12345678-1234-1234-1234-123456789012",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-20T14:45:30.000Z",
  "customerId": "user_123456789abcdef",
  "managerId": "user_987654321fedcba",
  "tenantId": "tenant_123456789abcdef",
  "adminId": "user_abcdef123456789"
}

Explicação da resposta:

Campo	Tipo	Descrição	Exemplo
id	string	ID único da carteira	`"wallet_123456789abcdef"`
network	string	Rede da carteira	`"mainnet"`
blockchain	string	Blockchain da carteira	`"ethereum"`
type	string	Tipo da carteira	`"CUSTOMER"`
address	string	Endereço da carteira	`"0xabcdef1234567890abcdef1234567890abcdef12"`
label	string	Rótulo da carteira	`"CUSTOMER-ETHEREUM-MAINNET-12345678-1234-1234-1234-123456789012"`
createdAt	string	Data de criação	`"2024-01-15T10:30:00.000Z"`
updatedAt	string	Data de atualização	`"2024-01-20T14:45:30.000Z"`
customerId	string	ID do cliente	`"user_123456789abcdef"`
managerId	string	ID do gerente	`"user_987654321fedcba"`
tenantId	string	ID do tenant	`"tenant_123456789abcdef"`
adminId	string	ID do administrador	`"user_abcdef123456789"`

⚠️ Possíveis erros

Código	Erro	Causa comum
400	Bad Request	ID da carteira inválido
401	Unauthorized	Token inválido ou ausente
500	Internal Server Error	Erro interno do serviço

🎯 Como usar a consulta de carteira por ID

Após receber a resposta, você pode:

Verificar detalhes: Use todos os campos para obter informações completas
Identificar tipo: Use type para verificar o tipo de carteira
Verificar rede: Use network e blockchain para confirmar a rede
Usar endereço: Use address para transações
Verificar permissões: Use os IDs de usuário para verificar permissões

🛡️ Limitações e restrições

✅ FAÇA:

Sempre use autenticação válida
Use IDs válidos de carteira
Verifique todos os campos retornados
Confirme o tipo da carteira
Verifique as permissões antes de usar

❌ NÃO FAÇA:

Ignorar a autenticação
Usar IDs inválidos
Ignorar os campos retornados
Assumir permissões sem verificar

🆘 Problemas comuns

“Estou recebendo erro 400!”

Verifique se o ID da carteira é válido
Confirme se o token é válido
Verifique se a carteira existe no sistema

“Erro 401!”

Verifique se o token de autenticação é válido
Faça uma nova autenticação se necessário

“Carteira não encontrada!”

Verifique se o ID está correto
Confirme se a carteira existe
Verifique se você tem permissão para acessar

📞 Suporte

Se nada funcionar:

Verifique se o ID da carteira é válido
Confirme se o token de autenticação é válido
Verifique se a carteira existe no sistema
Entre em contato com nossa equipe de suporte

Mais Informações sobre esse endpoint:

Acesse aqui