Token API는 POP-UP 기반 화면에 사용되는 인증 토큰을 발급합니다.
발급된 토큰은 임베드 URL에 포함되어, 사용자가 별도 로그인 없이 인증된 상태로 화면에 접근할 수 있도록 지원합니다.
•
반복 호출이 가능하지만, 가장 최근 발급된 2개의 토큰만 유효합니다.
•
토큰은 24시간마다 갱신해 주셔야 합니다.
인증 방법
Swagger UI를 통해 인증을 진행합니다.
인증 방식은 Basic 인증(ID/PW 입력 방식)을 사용합니다.
인증 절차
1.
Swagger 문서 접속
2.
우측 상단의 [Authorize] 클릭
3.
제공받은 아이디 / 비밀번호 입력
4.
[Authorize] 클릭하여 인증 수행
5.
인증 완료 후 [Close] 클릭
인증이 완료되면 호출되는 모든 요청에 인증 토큰이 자동으로 포함됩니다.
Token 발급 방법
1. 구성 선택
Token 항목을 선택합니다.
2. Swagger UI에서 실행
1.
/token/publish 경로 선택
2.
[Try it Out] 클릭
3.
[Execute] 클릭
4.
하단 응답 영역에서 토큰 정보 확인
응답 형식 예시
json
복사편집
{
"code": 200,
"message": "success",
"error": false,
"timestamp": "2025-02-26T10:08:10.005543",
"response": {
"tokenId": "3a3803cd-e042-4463-9da4-bec0e2974e5c",
"aud": "exampleUser@example.com",
"iss": "seavantage.com",
"iat": "2025-02-26T01:08:09.912566",
"exp": "2025-03-05T01:08:09.912566"
}
}
JSON
복사
주요 필드 설명
필드명 | 예시 값 | 설명 |
tokenId | 3a3803cd-e042-4463-9da4-bec0e2974e5c | 발급된 토큰 ID |
aud | exampleUser@example.com | 토큰 대상 사용자 |
iss | seavantage.com | 토큰 발급 주체 도메인 |
iat | 2025-02-26T01:08:09.912566 | 토큰 발급 시각 (UTC) |
exp | 2025-03-05T01:08:09.912566 | 토큰 만료 시각 (UTC) |
응답 코드 안내
코드 | 의미 |
200 | 요청 성공 |
201 | 생성 완료 |
400 | 잘못된 요청 |
401 | 인증 필요 |
403 | 권한 없음 |
422 | 처리 불가 |
429 | 요청 과다 |
관련 링크
필요 시 이 가이드를 Notion에 최적화된 마크다운 파일 또는 공유 페이지 형식으로 제공해 드릴 수 있습니다. 원하시는 출력 형식이 있으시면 알려주세요.