로그인

비밀번호 초기화

put

기능설명

• 계정의 비밀번호를 초기화합니다.

---

상세설명

• 입력한 휴대폰 번호와 입력한 아이디 계정의 휴대폰 번호가 일치해야만 초기화 처리가 가능합니다.

• 알파벳 소문자 5자, 숫자3자, 특수문자2자 가 랜덤으로 조합됩니다.

• 초기화 된 비밀번호 안내 알림톡(카카오톡)이 입력한 휴대폰 번호로 발송됩니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

seqinteger · int64Optional

loginIdstring · min: 1Required

passwordstringOptional

remoteAddrstringOptional

lastAccessTimeinteger · int64Optional

userGbCdstringOptional

rtGrpNostringOptional

jobGrpCdstringOptional

ocpCdstringOptional

caloUrlstringOptional

sysGbCdstringOptional

userIdstringOptional

pwdstringOptional

userNmstringOptional

cellSctNostringOptional

cellTxnoNostringOptional

cellEndNostringOptional

pwdIniYnstringOptional

sessIdstringOptional

tpCdstringOptional

entrNostringOptional

entrNmstringOptional

applicationNamestringOptional

credentialsNonExpiredbooleanOptional

accountNonExpiredbooleanOptional

accountNonLockedbooleanOptional

usernamestringOptional

namestringOptional

enabledbooleanOptional

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

put

/v1/login/initializePasswordOnLogin

HTTPcURLJavaScriptPython

PUT /api/bo/v1/login/initializePasswordOnLogin HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 664

{
  "seq": 1,
  "loginId": "text",
  "password": "text",
  "remoteAddr": "text",
  "lastAccessTime": 1,
  "userGbCd": "text",
  "rtGrpNo": "text",
  "jobGrpCd": "text",
  "ocpCd": "text",
  "caloUrl": "text",
  "sysGbCd": "text",
  "userId": "text",
  "pwd": "text",
  "userNm": "text",
  "cellSctNo": "text",
  "cellTxnoNo": "text",
  "cellEndNo": "text",
  "pwdIniYn": "text",
  "sessId": "text",
  "tpCd": "text",
  "entrNo": "text",
  "entrNm": "text",
  "applicationName": "text",
  "privacyPolicyInfoList": [
    {
      "userId": "x2bee",
      "indInfoGbCd": "01",
      "useYn": "Y"
    }
  ],
  "credentialsNonExpired": true,
  "accountNonExpired": true,
  "accountNonLocked": true,
  "permissionToViewPersonalInfo": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "username": "text",
  "name": "text",
  "enabled": true
}

{
  "timestamp": "2026-02-27T16:43:06.781Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

로그인 토큰 갱신(Refresh)

post

기능설명

• 토큰 갱신을 수행합니다.

---

상세설명

• refresh token을 이용하여 access token을 갱신합니다.

• refresh token은 쿠키에 저장되어 있어야 합니다.

• 발급받은 access token은 헤더에 accessToken으로 포함하여 사용합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

토큰 갱신 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

401

토큰 갱신 실패

*/*

post

/v2/token/refresh

HTTPcURLJavaScriptPython

POST /api/bo/v2/token/refresh HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T16:43:06.781Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "accessToken": "text",
    "refreshToken": "text"
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Access Token 검증

post

기능설명

• Access Token 검증을 수행합니다.

---

상세설명

• Access Token 을 이용하여 토큰의 상태를 확인합니다.

• 토큰이 만료된 경우와 이상한지를 구분하여 반환합니다.

• 토큰이 정상인 경우는 로그인 아이디를 반환합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

로그인 Response V2

accessTokenstringOptional

Access Token

refreshTokenstringOptional

Refresh Token

Responses

200

토큰 검증 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

401

토큰 검증 실패

*/*

post

/v2/token/access

HTTPcURLJavaScriptPython

POST /api/bo/v2/token/access HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "accessToken": "text",
  "refreshToken": "text"
}

{
  "timestamp": "2026-02-27T16:43:06.781Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

로그아웃

post

기능설명

• 로그아웃을 수행합니다.

---

상세설명

• refresh token을 이용하여 로그아웃을 수행합니다.

• refresh token은 쿠키에 저장되어 있어야 합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

로그아웃 성공

*/*

stringOptional

post

/v2/logout

HTTPcURLJavaScriptPython

POST /api/bo/v2/logout HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

로그아웃 성공

text

로그인

post

기능설명

• 로그인을 수행합니다.

---

상세설명

• id, password를 입력받아 로그인을 수행합니다.

• 로그인 성공시 access token, refresh token을 발급합니다.

• 발급받은 access token은 헤더에 accessToken으로 포함하여 사용합니다.

• 발급받은 refresh token은 쿠키에 저장하여 사용합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

seqinteger · int64Optional

loginIdstring · min: 1Required

passwordstringOptional

remoteAddrstringOptional

lastAccessTimeinteger · int64Optional

userGbCdstringOptional

rtGrpNostringOptional

jobGrpCdstringOptional

ocpCdstringOptional

caloUrlstringOptional

sysGbCdstringOptional

userIdstringOptional

pwdstringOptional

userNmstringOptional

cellSctNostringOptional

cellTxnoNostringOptional

cellEndNostringOptional

pwdIniYnstringOptional

sessIdstringOptional

tpCdstringOptional

entrNostringOptional

entrNmstringOptional

applicationNamestringOptional

credentialsNonExpiredbooleanOptional

accountNonExpiredbooleanOptional

accountNonLockedbooleanOptional

usernamestringOptional

namestringOptional

enabledbooleanOptional

Responses

200

로그인 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadanyOptional

payload

errorbooleanOptional

is error

401

로그인 실패

*/*

post

/v2/login

HTTPcURLJavaScriptPython

POST /api/bo/v2/login HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 664

{
  "seq": 1,
  "loginId": "text",
  "password": "text",
  "remoteAddr": "text",
  "lastAccessTime": 1,
  "userGbCd": "text",
  "rtGrpNo": "text",
  "jobGrpCd": "text",
  "ocpCd": "text",
  "caloUrl": "text",
  "sysGbCd": "text",
  "userId": "text",
  "pwd": "text",
  "userNm": "text",
  "cellSctNo": "text",
  "cellTxnoNo": "text",
  "cellEndNo": "text",
  "pwdIniYn": "text",
  "sessId": "text",
  "tpCd": "text",
  "entrNo": "text",
  "entrNm": "text",
  "applicationName": "text",
  "privacyPolicyInfoList": [
    {
      "userId": "x2bee",
      "indInfoGbCd": "01",
      "useYn": "Y"
    }
  ],
  "credentialsNonExpired": true,
  "accountNonExpired": true,
  "accountNonLocked": true,
  "permissionToViewPersonalInfo": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "username": "text",
  "name": "text",
  "enabled": true
}

{
  "timestamp": "2026-02-27T16:43:06.781Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": null,
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

로그인 사용자 정보

get

기능설명

• 로그인 된 사용자의 정보를 반환합니다.

---

상세설명

• 로그인 사용자의 아이다를 통해 사용자 조회 후 비민감 데이터를 반환합니다.

• access token이 필요합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get

/v2/login/auth

HTTPcURLJavaScriptPython

GET /api/bo/v2/login/auth HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "timestamp": "2026-02-27T16:43:06.781Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "userId": "text",
    "userNm": "text",
    "emailAddr": "text",
    "entrNo": "text",
    "entrNm": "text",
    "userGbCd": "text",
    "rtGrpNo": "text",
    "jobGrpCd": "text",
    "sysGbCd": "text",
    "rcntUseDtm": "2026-02-27T16:43:06.781Z",
    "userIpAddr": "text",
    "indInfoDealYn": "text"
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}