도매꾹 Open API

로그인 체크

현재 로그인 세션이 유효한지와 로그인 유지 만료 갱신 여부를 확인하는 API입니다

로그인 API(setLogin) 호출로 받은 세션값(sId)과 로그인 유지 여부(loginKeep) 를 전달해,

현재 로그인 세션이 유효한지와 로그인 유지 만료 갱신 여부를 확인하는 API입니다.


권장ver: 4.0

Mode: setLoginChk

Method: POST

Endpoint: https://domeggook.com/ssl/api/

Request Example:

하단 예시 참고

JSON

순서

항목(자료형, 필수여부)

설명

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

회원 이름

JSON

순서

항목(자료형, 필수여부)

설명

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 별로 다름

JSON

순서

항목(자료형, 필수여부)

설명

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 별로 다름

XML

버전 기록

  • v1.0: 로그인 시 발급받은 sId(세션값) 과 loginKeep(로그인 유지 여부), sIdRenewDate를 전달해 세션 유효성 및 로그인 유지 갱신 여부를 확인

  • v1.1

    • v1.0 흐름 유지 + om(출력형식: json/xml) 필드가 추가/명시

  • v4.0

    • v1.1 흐름 유지

    • response 내 cId 추가