로그인 및 토큰 발급
Log In for Tokens
사용자 이름과 비밀번호로 access token 및 refresh token을 발급받습니다.
POST
https://console.synleapenergy.com/open-api/v1/token/login 본문 매개변수application/json
userNamestring필수사용자 이름, 최대 64자.
passwordstring필수비밀번호, 최대 72자.
사용 안내
- access token은 24시간, refresh token은 90일 동안 유효합니다.
응답
200성공 응답application/json
| 필드 | 유형 | 설명 |
|---|---|---|
accessToken | string | 업무 API 호출용 access token |
refreshToken | string | 토큰 갱신용 refresh token |
accessExpiresAt | integer | access token 만료 시각(Unix 밀리초 타임스탬프) |
refreshExpiresAt | integer | refresh token 만료 시각(Unix 밀리초 타임스탬프) |
4xx / 5xx오류 응답application/json
| HTTP 상태 | 오류 코드 | 설명 |
|---|---|---|
| 400 | 400 | 로그인 요청이 올바르지 않습니다. userName과 password가 비어 있지 않고 길이 제한을 지키는지 확인하세요. |
| 403 | 1050041007 | visit-tenant-id 허용 안 됨 |
| 429 | 1050041008 | 호출 제한 초과, Retry-After초 대기 |
| 429 | 1050041010 | 계정에 동시에 존재하는 토큰이 10개를 초과했습니다. |
| 401 | 1050041014 | 로그인 인증 실패 |
| 503 | 500 | 서비스를 일시적으로 사용할 수 없습니다. 나중에 다시 시도하세요. |