인증 요청 (Authentication Request)
사용자 정보 조회 및 수정을 위해 먼저 인증 토큰을 발급해야 합니다.
발급된 토큰은 1분간 유효하며, 이후 모든 요청의 HTTP 헤더에 X-Access-Token
을 포함해야 합니다.
이 토큰을 통해 사용자 계정의 보안을 유지하고, 불필요한 장기 세션 없이 안전하게 인증을 수행할 수 있습니다.
이 API는 퍼스널 요금제 이상에서만 제공됩니다.
POST
/api/user/v1/auth
{
"eml": "your@gmail.com"
}
Request Parameters
- emlstring
- 이메일.
비즈니스 요금제 이상에서 조직 내 추가된 사용자의 정보를 조회하거나 변경할 때 지정합니다.
퍼스널 및 프리미엄 요금제에서는 이 값이 무시됩니다.
{
"code": 0,
"message": "",
"result": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
Response Parameters
- codeinteger
- 응답 코드: 0 = 성공, 그 외 값 = 오류
- messagestring
- 응답 메시지입니다. 응답 코드가 0이 아니면, 오류 관련 메시지가 반환됩니다.
- resultstring
- 사용자 정보 조회 및 수정 요청 시, HTTP 헤더의
X-Access-Token
항목에 추가해야 합니다.
토큰은 1분간 유효하며, 만료 후에는 재발급(본 API 재호출)이 필요합니다.