콘텐츠로 이동

로그인 이용내역 조회

Endpoint

[POST] API URL 정보

https://patch-bnd.happytalk.io/user/api/login-history

https://bnd.happytalk.io/user/api/login-history

Request (Json)

None

Body

Field Name Type (Length) Required Description Default
token String Y 고객사 토큰
start_date String Y 검색 시작 일시 (Y-m-d H:i:s)
end_date String Y 검색 종료 일시 (Y-m-d H:i:s)

조회시 주의사항

최대 조회기간은 하루입니다. (start_date 와 end_date 의 간격은 24시간 미만이어야 합니다.)

Example

REST API Sample 
curl --location --request POST 'https://patch-bnd.happytalk.io/user/api/login-history' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token" : "고객사 토큰",
    "start_date" : "2026-06-02 00:00:00",
    "end_date" : "2026-06-02 23:59:59"
}'

curl --location --request POST 'https://bnd.happytalk.io/user/api/login-history' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token" : "고객사 토큰",
    "start_date" : "2026-06-02 00:00:00",
    "end_date" : "2026-06-02 23:59:59"
}'

Response (Json)

응답 해석 안내

기간 내 로그인 이력(apply_content='로그인')만 대상으로, 이벤트명을 영문 변환한 SIEM 문자열 배열을 반환합니다.
서비스 이용내역 조회(siem)와 달리 각 줄 끝에 ,msg=... 가 붙지 않으며, clientip 은 각 로그인 행 자체의 IP 정보입니다.

Parameter

Field Name Type Description
result String success : 성공 , fail : 실패
data Array 로그인 이력 SIEM 문자열 배열

Example

Success 
{
  "result": "success",
  "data": [
    "Jun 02 2026 09:00:00.000 KST,Event_name=login,Result=Succeeded,user=홍길동,clientip=192.168.1.100",
    "Jun 02 2026 08:30:00.000 KST,Event_name=login,Result=Succeeded,user=김상담,clientip=203.0.113.50"
  ]
}
Failure

Fail Code 정보

Data Dictionary

Data Dictionary

None

SIEM 문자열은 , 로 구분된 key=value 형태이며, 한 줄이 하나의 로그인 이력입니다.
형식: {발생일시},Event_name={이벤트명},Result=Succeeded,user={발생자},clientip={IP}

Segment Description
(발생일시) Mon DD YYYY HH:mm:ss.000 KST 형식의 로그인 발생 일시
Event_name 이벤트명 (영문 변환된 값)
Result 처리 결과. 항상 Succeeded 고정
user 로그인한 사용자 (request_user)
clientip 해당 로그인 행의 클라이언트 IP