관리자 비밀번호 API

참고: 이 문서에 설명된 모든 API는 dta-wi-mono 모노레포의 dta-wi-medi-api 애플리케이션에 구현되어 있습니다.

개요

관리자 비밀번호 API는 MD 계정의 비밀번호 재설정을 위한 전체 프로세스를 제공합니다.

주요기능

• 보안 코드 발송: MD 계정에 비밀번호 재설정을 위한 보안 코드를 이메일로 발송
• 보안 코드 검증: 비밀번호 재설정을 위한 보안 코드 검증 및 토큰 발급

[POST] /v1/admin/accounts/password/reset/security-code/send - 비밀번호 재설정 보안 코드 발송

비밀번호 재설정 보안 코드 발송

관리자가 MD 계정에 비밀번호 재설정을 위한 보안 코드를 발송합니다.

• HTTP Method: POST
• 인증: 액세스 토큰 (accessToken) 필요

Headers

Header	Type	Description	Required
Authorization	Bearer {accessToken}	사용자 인증을 통해 발급받은 액세스 토큰 입니다.	✔
Content-Type	application/json	요청 본문 형식	✔

Request Body

필드	타입	설명	Required
accountIds	string[]	MD 계정 UUID 배열	✔

Request Body 예시

{
  "accountIds": ["123e4567-e89b-12d3-a456-426614174000", "123e4567-e89b-12d3-a456-426614174001"]
}

Responses

Http Status Code	설명	Error Code(s)
200 OK	발송 성공	-
401 Unauthorized	인증 실패	1080
500 Internal Server Error	서버 내부 오류	1092

200 OK - 성공

{
  "success": true,
  "failedAccountIds": []
}

필드	타입	설명
success	boolean	전체 발송 성공 여부
failedAccountIds	string[]	발송 실패한 계정 ID 목록 (비어있을 수 있음)

200 OK - 일부 실패

{
  "success": false,
  "failedAccountIds": [
    "123e4567-e89b-12d3-a456-426614174001"
  ]
}

401 Unauthorized - 인증 실패

{
  "status": 401,
  "code": 1080,
  "message": "UNAUTHORIZED",
  "detail": "{\"displayText\":\"No token found in Authorization header\"}"
}

[POST] /v1/accounts/password/reset/security-code/verify - 보안 코드 검증

보안 코드 검증

비밀번호 재설정을 위한 보안 코드를 검증하고, 검증 성공 시 비밀번호 재설정에 사용할 토큰을 발급합니다.

** 도메인 이동 필요 **

• HTTP Method: POST
• 인증: 액세스 토큰 (accessToken) 필요

Headers

Header	Type	Description	Required
Authorization	Bearer {accessToken}	사용자 인증을 통해 발급받은 액세스 토큰 입니다.	✔
Content-Type	application/json	요청 본문 형식	✔

Request Body

필드	타입	설명	Required
accountId	string	계정 UUID	✔
code	string	비밀번호 재설정 보안코드	✔

Request Body 예시

{
  "accountId": "123e4567-e89b-12d3-a456-426614174000",
  "code": "123456"
}

Responses

Http Status Code	설명	Error Code(s)
200 OK	검증 성공	-
401 Unauthorized	인증 실패	1080
500 Internal Server Error	서버 내부 오류	1092

200 OK - 성공

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

필드	타입	설명
token	string	비밀번호 재설정용 임시 토큰

401 Unauthorized - 인증 실패

{
  "status": 401,
  "code": 1080,
  "message": "UNAUTHORIZED",
  "detail": "{\"displayText\":\"No token found in Authorization header\"}"
}