Autorização

Este endpoint permite obter um token de acesso para utilizar nos demais endpoints da API. É o primeiro passo obrigatório para acessar qualquer recurso protegido da plataforma Ether Global Assets.

📍 Endpoint

POST https://api.etherglobalassets.com/auth/authenticate

🧾 Cabeçalhos obrigatórios (Headers)

Cabeçalho	Valor	Descrição
Content-Type	application/json	Formato do corpo da requisição

🧰 Corpo da Requisição (JSON)

{
  "clientId": "1234567890",
  "clientSecret": "1234567890"
}

Explicação dos campos:

Campo	Tipo	Obrigatório	Descrição
clientId	string	✅	ClientId do cliente
clientSecret	string	✅	Secret do cliente

📌 Exemplo com curl

curl https://api.etherglobalassets.com/auth/authenticate \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
    "clientId": "1234567890",
    "clientSecret": "1234567890"
  }'

✅ Dica: Substitua os valores de exemplo pelas suas credenciais reais fornecidas pela equipe Ether Global Assets.

✅ Resposta esperada (HTTP 200 - OK)

{
  "accessToken": "eyJraWQiOiJabc123...",
  "expiresIn": 3600,
  "tokenType": "Bearer"
}

Explicação da resposta:

Campo	Tipo	Descrição
accessToken	string	Token de acesso JWT
expiresIn	number	Tempo de expiração em segundos (3600 = 1 hora)
tokenType	string	Tipo do token (sempre “Bearer”)

⚠️ Possíveis erros

Código	Erro	Causa comum
400	Bad Request	Credenciais inválidas ou formato incorreto
500	Internal Server Error	Erro interno do serviço

🎯 Como usar o token retornado

Após receber o token de acesso, você deve incluí-lo no cabeçalho Authorization de todas as requisições subsequentes:

curl https://api.etherglobalassets.com/users/bank-account/details \
  --request GET \
  --header 'Authorization: Bearer eyJraWQiOiJabc123...' \
  --header 'Content-Type: application/json'

🕐 Validade do token

Duração: 1 hora (3600 segundos)
Renovação: Faça uma nova autenticação quando expirar
Reutilização: Use o mesmo token para múltiplas requisições até expirar

🛡️ Dicas de segurança

✅ FAÇA:

Guarde suas credenciais em lugar seguro
Use sempre HTTPS (a API já força isso)
Use o token apenas para suas próprias operações

❌ NÃO FAÇA:

Compartilhar seu token com outras pessoas
Deixar suas credenciais visíveis no código
Usar o mesmo token por muito tempo

🆘 Problemas comuns

“Meu token não está funcionando!”

Verifique se não expirou (mais de 1 hora)
Faça uma nova autenticação

“Estou recebendo erro 400!”

Confirme se clientId e clientSecret estão corretos
Verifique se não há espaços extras

“Erro 500 toda vez!”

Pode ser um problema temporário
Aguarde alguns minutos e tente novamente

📞 Suporte

Se nada funcionar:

Verifique suas credenciais primeiro.
Teste com curl para isolar o problema.
Entre em contato com nossa equipe de suporte@etherglobalassets.com.br.

Mais informações sobre o endpoint:

Acesse agora