로그인 API(setLogin) 호출로 받은 세션값(sId)과 로그인 유지 여부(loginKeep) 를 전달해,
현재 로그인 세션이 유효한지와 로그인 유지 만료 갱신 여부를 확인하는 API입니다.
권장ver: 4.0
Mode: setLoginChk
Method: POST
Endpoint: https://domeggook.com/ssl/api/
Request Example:
하단 예시 참고
순서 | 항목(자료형, 필수여부) | 설명 |
1 | ver (string,Y) | API Version: 4.0 입력 |
2 | mode (string,Y) | API 호출 모드값 : setLoginChk |
3 | aid (string,Y) | API KEY |
4 | id (string,Y) | 회원 아이디 |
5 | sId (string,Y) | 로그인 API 호출로 발급되는 sId |
6 | loginKeep (string,N) | 로그인 API를 호출할 때 "로그인 유지"에 체크했는지 여부를 입력 · on : 로그인 만료시각을 API 호출시점부터 30일 후로 연장(로그인 유지 체크함) · off : 로그인 만료시각을 API 호출시점부터 24시간 후로 연장(로그인 유지 체크안함) ※ setLogin 시점의 loginKeep 설정에 따라 세션 만료 연장 정책(예: 24시간/30일)이 결정됨setLoginChk에서 loginKeep 값을 다르게 보내더라도, 정책 자체가 변경되지는 않으며, 갱신이 발생하면(updateExpire=TRUE) 기존 정책 기준으로 expireDate가 연장 |
7 | sIdRenewDate (int,Y) | 가장 최근에 본 API를 호출하여 수신한 sIdRenewDate 값을 다시 입력 |
8 | om (string,N) | 출력 형식 : json | xml |
순서 | 항목 | 자료형 | 설명 |
|---|---|---|---|
1 | updateExpire | string | 로그인 만료시각 갱신여부· TRUE : 로그인 만료시각 갱신· FALSE : 로그인 만료시각을 갱신하지 않음※ 본 API가 마지막으로 호출된 시점으로부터 1초 미만의 시간 간격을 두고 다시 호출된 경우에는, 로그인 만료시각이 갱신되지 않음 |
2 | expireDate | int | 세션 만료일 |
3 | result | boolean | 로그인 세션이 유효한지 여부· TRUE : 로그인 세션 유효· 로그인 세션이 유효하지 않은 경우에는 표준오류 메시지를 반환하므로, 사실상 이 값은 항상 true를 반환함 |
4 | sIdRenewDate | int | loginKeepTime 로그인 유지 갱신 시간 : 현재일시 + 180초 |
5 | sId | string | 세션 아이디 값 |
6 | cId | string | Checksum |
7 | id | string | 회원 아이디 |
8 | name | string | 회원 이름 |
순서 | 항목(자료형, 필수여부) | 설명 |
1 | ver (string,Y) | API Version: 1.1 입력 |
2 | mode (string,Y) | API 호출 모드값 : setLoginChk |
3 | aid (string,Y) | API KEY |
4 | id (string,Y) | 회원 아이디 |
5 | sId (string,Y) | 로그인 API 호출로 발급되는 sId |
6 | loginKeep (string,N) | 로그인 API를 호출할 때 "로그인 유지"에 체크했는지 여부를 입력 · on : 로그인 만료시각을 API 호출시점부터 30일 후로 연장(로그인 유지 체크함) · off : 로그인 만료시각을 API 호출시점부터 24시간 후로 연장(로그인 유지 체크안함) ※ setLogin 시점의 loginKeep 설정에 따라 세션 만료 연장 정책(예: 24시간/30일)이 결정됨setLoginChk에서 loginKeep 값을 다르게 보내더라도, 정책 자체가 변경되지는 않으며, 갱신이 발생하면(updateExpire=TRUE) 기존 정책 기준으로 expireDate가 연장 |
7 | sIdRenewDate (int,Y) | 가장 최근에 본 API를 호출하여 수신한 sIdRenewDate 값을 다시 입력 |
8 | om (string,Y) | 출력 형식 : json | xml |
순서 | 항목 | 자료형 | 설명 |
|---|---|---|---|
1 | updateResult | boolean | 로그인 만료시각 갱신여부· true : 로그인 만료시각 갱신· false : 로그인 만료시각을 갱신하지 않음※ 본 API가 마지막으로 호출된 시점으로부터 1초 미만의 시간 간격을 두고 다시 호출된 경우에는, 로그인 만료시각이 갱신되지 않음 |
2 | result | boolean | 로그인 세션이 유효한지 여부· true : 로그인 세션 유효· 로그인 세션이 유효하지 않은 경우에는 표준오류 메시지를 반환하므로, 사실상 이 값은 항상 true를 반환함 |
3 | sIdRenewDate | date | loginKeepTime 로그인 유지 갱신 시간 : 현재일시 + 180초 |
4 | sId | string | 세션 아이디 값 |
5 | id | string | 회원 아이디 |
6 | name | string | 회원 이름 |
7 | admin | string | 관리자 권한이 있을경우 Level 별로 다름 |
순서 | 항목(자료형, 필수여부) | 설명 |
1 | ver (int,Y) | api version: 1.0 입력 |
2 | mode (int,Y) | api 호출 모드 값 : setLoginChk |
3 | aid (int,Y) | API KEY |
4 | id (int,Y) | 회원 아이디 |
5 | sId (int,Y) | 세션값 |
6 | loginKeep (int,Y) | 로그인 API를 호출할 때 "로그인 유지"에 체크했는지 여부를 입력 · on : 로그인 만료시각을 API 호출시점부터 30일 후로 연장(로그인 유지 체크함) · off : 로그인 만료시각을 API 호출시점부터 24시간 후로 연장(로그인 유지 체크안함) ※ setLogin 시점의 loginKeep 설정에 따라 세션 만료 연장 정책(예: 24시간/30일)이 결정됨setLoginChk에서 loginKeep 값을 다르게 보내더라도, 정책 자체가 변경되지는 않으며, 갱신이 발생하면(updateExpire=TRUE) 기존 정책 기준으로 expireDate가 연장 |
7 | sIdRenewDate (int,Y) | 로그인 유지 시간 갱신 ( 마지막 로그인 체크시간 3분, 현재 시간보다 지났을 경우 로그인 유지시간 갱신 ) - timestamp |
순서 | 항목 | 자료형 | 설명 |
|---|---|---|---|
1 | updateResult | string | true ( 로그인 유지 시간 갱신 ) - 갱신 되었을때만 출력 |
2 | result | string | true ( 로그인 체크 결과) |
3 | sIdRenewDate | date | time() + 60 * 3 |
4 | sId | string | 세션값 |
5 | id | string | 회원 아이디 |
6 | name | string | 회원 이름 |
7 | admin | string | 관리자 권한이 있을경우 Level 별로 다름 |
버전 기록
v1.0: 로그인 시 발급받은 sId(세션값) 과 loginKeep(로그인 유지 여부), sIdRenewDate를 전달해 세션 유효성 및 로그인 유지 갱신 여부를 확인
v1.1
v1.0 흐름 유지 + om(출력형식: json/xml) 필드가 추가/명시
v4.0
v1.1 흐름 유지
response 내 cId 추가