> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/api-en/store-front-api-reference/member-api/login.md).

# Login

## Process Social Login

> \## Function Description\
> \* Links a social account for a member who is not yet linked and issues a token.\
> \---\
> \## Detailed Description\
> \* \*\*Social type (type)\*\*, \*\*Member No. (mbrNo)\*\*, \*\*Social account unique ID (smpctId)\*\*, \*\*Social ID (emailAddr)\*\*, and \*\*Login media code (loginMediaCd)\*\* are required.\
> \* Checks whether existing linkage data exists for the given social type.\
> \* Saves the social account linkage information to the existing member. The link end date is set to 2999-12-31 23:59:59.\
> \* Once social linking is successfully completed, a token is issued in the same way as regular token issuance.\
> \* If the token is successfully issued, a successful login history is created; if it fails, a failed login history is created.\
> \---\
> \## Revision History\
> \* \`\`\`Release v2.00\_240401\`\`\`: Added refreshToken to social login processing response<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE Member API","version":"v1"},"servers":[{"url":"https://api-member.x2bee.com/api/member/","description":"prd"}],"paths":{"/v1/social/connect":{"post":{"tags":["Login"],"summary":"Process Social Login","description":"## Function Description\n* Links a social account for a member who is not yet linked and issues a token.\n---\n## Detailed Description\n* **Social type (type)**, **Member No. (mbrNo)**, **Social account unique ID (smpctId)**, **Social ID (emailAddr)**, and **Login media code (loginMediaCd)** are required.\n* Checks whether existing linkage data exists for the given social type.\n* Saves the social account linkage information to the existing member. The link end date is set to 2999-12-31 23:59:59.\n* Once social linking is successfully completed, a token is issued in the same way as regular token issuance.\n* If the token is successfully issued, a successful login history is created; if it fails, a failed login history is created.\n---\n## Revision History\n* ```Release v2.00_240401```: Added refreshToken to social login processing response\n","operationId":"connect","parameters":[{"name":"socialConnectRequest","in":"query","description":"Member Information for Social Login Linking","required":true,"schema":{"type":"string","description":"SocialConnectRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialConnectRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SocialAuthResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
````

## Social Account Authentication

> \## Function Description\
> \* Finds and authenticates the social account information to log in, then determines the post-processing method.\
> \---\
> \## Detailed Description\
> \* The \*\*authorization code (code)\*\* passed from the consent screen and the \*\*social type (type)\*\* to log in with are required.\
> \* An access token for looking up the user is issued via the authorization code (code) passed from the social site's consent screen, and the social account is found.\
> \* The response includes whether identity verification is required, based on the social account's prior linkage status, dormant member status, and CI verification status.\
> \* Kakao login related API \[Kakao Developer Link]\(<https://developers.kakao.com)\\>
> &#x20;  \* User lookup token issuance URL: <https://kauth.kakao.com/oauth/token\\>
> &#x20;  \* User lookup URL: <https://kapi.kakao.com/v2/user/me\\>
> &#x20;  \* Unlink URL: <https://kapi.kakao.com/v1/user/unlink\\>
> \* Naver login related API \[Naver Developer Link]\(<https://developers.naver.com/main)\\>
> &#x20;  \* User lookup token issuance URL: <https://nid.naver.com/oauth2.0/token\\>
> &#x20;  \* User lookup URL: <https://openapi.naver.com/v1/nid/me\\>
> \* Google login related API \[Google Developer Link]\(<https://console.cloud.google.com)\\>
> &#x20;  \* User lookup token issuance URL: <https://oauth2.googleapis.com/token\\>
> &#x20;  \* User lookup URL: <https://www.googleapis.com/oauth2/v2/userinfo\\>
> \* Apple login related API \[Apple Developer Link]\(<https://developer.apple.com)\\>
> &#x20;  \* User lookup token issuance URL: <https://appleid.apple.com/auth/token\\>
> \---\
> \## Revision History\
> \* \`\`\`Release v1.07\_231228\`\`\`: Removed dormant member status lookup logic\
> \* \`\`\`Release v2.00\_240530\`\`\`: Added social providers (Google, Apple)<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE Member API","version":"v1"},"servers":[{"url":"https://api-member.x2bee.com/api/member/","description":"prd"}],"paths":{"/v1/social/check":{"post":{"tags":["Login"],"summary":"Social Account Authentication","description":"## Function Description\n* Finds and authenticates the social account information to log in, then determines the post-processing method.\n---\n## Detailed Description\n* The **authorization code (code)** passed from the consent screen and the **social type (type)** to log in with are required.\n* An access token for looking up the user is issued via the authorization code (code) passed from the social site's consent screen, and the social account is found.\n* The response includes whether identity verification is required, based on the social account's prior linkage status, dormant member status, and CI verification status.\n* Kakao login related API [Kakao Developer Link](https://developers.kakao.com)\n   * User lookup token issuance URL: https://kauth.kakao.com/oauth/token\n   * User lookup URL: https://kapi.kakao.com/v2/user/me\n   * Unlink URL: https://kapi.kakao.com/v1/user/unlink\n* Naver login related API [Naver Developer Link](https://developers.naver.com/main)\n   * User lookup token issuance URL: https://nid.naver.com/oauth2.0/token\n   * User lookup URL: https://openapi.naver.com/v1/nid/me\n* Google login related API [Google Developer Link](https://console.cloud.google.com)\n   * User lookup token issuance URL: https://oauth2.googleapis.com/token\n   * User lookup URL: https://www.googleapis.com/oauth2/v2/userinfo\n* Apple login related API [Apple Developer Link](https://developer.apple.com)\n   * User lookup token issuance URL: https://appleid.apple.com/auth/token\n---\n## Revision History\n* ```Release v1.07_231228```: Removed dormant member status lookup logic\n* ```Release v2.00_240530```: Added social providers (Google, Apple)\n","operationId":"check","parameters":[{"name":"socialLoginRequest","in":"query","description":"Social Login Authentication Information","required":true,"schema":{"type":"string","description":"SocialAuthRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialAuthRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SocialAuthResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
````