Iniciar sessão e obter tokens
Log In for Tokens
Obtenha um access token e um refresh token com utilizador e palavra-passe.
POST
https://console.synleapenergy.com/open-api/v1/token/login Parâmetros do corpoapplication/json
userNamestringObrigatórioUtilizador, até 64 caracteres.
passwordstringObrigatórioPalavra-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
| Campo | Tipo | Descrição |
|---|---|---|
accessToken | string | Access token para chamadas de negócio |
refreshToken | string | Refresh token para renovação |
accessExpiresAt | integer | Expiração do access token (timestamp Unix em milissegundos) |
refreshExpiresAt | integer | Expiração do refresh token (timestamp Unix em milissegundos) |
4xx / 5xxResposta de erroapplication/json
| Estado HTTP | Código de erro | Descrição |
|---|---|---|
| 400 | 400 | Pedido de início de sessão inválido. Confirme que userName e password não estão vazios e respeitam os limites de comprimento. |
| 403 | 1050041007 | visit-tenant-id não permitido |
| 429 | 1050041008 | Limite excedido; aguarde Retry-After segundos |
| 429 | 1050041010 | A conta tem mais de 10 tokens em simultâneo. |
| 401 | 1050041014 | Autenticação falhou |
| 503 | 500 | O serviço está temporariamente indisponível. Tente novamente mais tarde. |