Ir para o conteúdo
SynleapDevelopers
Iniciar sessão e obter tokens
Referência API/Conta e autenticação

Iniciar sessão e obter tokens

Log In for Tokens

Obtenha um access token e um refresh token com utilizador e palavra-passe.

POSThttps://console.synleapenergy.com/open-api/v1/token/login
Permissão
Nenhuma
limit
30 / min no total; 10 / min por IP; 5 falhas para o mesmo utilizador ativam um bloqueio de 15 min

Parâmetros do corpoapplication/json

userNamestringObrigatório

Utilizador, até 64 caracteres.

passwordstringObrigatório

Palavra-passe, até 72 caracteres.

Notas de utilização

  • Os access tokens são válidos por 24 horas e os refresh tokens por 90 dias.

Respostas

200Resposta bem-sucedidaapplication/json
CampoTipoDescrição
accessTokenstringAccess token para chamadas de negócio
refreshTokenstringRefresh token para renovação
accessExpiresAtintegerExpiração do access token (timestamp Unix em milissegundos)
refreshExpiresAtintegerExpiração do refresh token (timestamp Unix em milissegundos)
4xx / 5xxResposta de erroapplication/json
Estado HTTPCódigo de erroDescrição
400400Pedido de início de sessão inválido. Confirme que userName e password não estão vazios e respeitam os limites de comprimento.
4031050041007visit-tenant-id não permitido
4291050041008Limite excedido; aguarde Retry-After segundos
4291050041010A conta tem mais de 10 tokens em simultâneo.
4011050041014Autenticação falhou
503500O serviço está temporariamente indisponível. Tente novamente mais tarde.
Synleap Open API · v1.1Última alteração:

Synleap Centro de ajuda