암호 인증

로그인 계정과 암호가 일치하는지 검증합니다. 인증 결과는 정상 응답의 status 값으로 반환됩니다.

필요 권한

관리자 이상의 계정으로 이용할 수 있습니다.

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -d login=gildong \
     -d password=PASSWORD \
     -X POST \
     https://HOSTNAME/api/sonar/verify-password

요청 매개변수

정상 응답

{
  "status": "ok"
}

• status (문자열): 인증 결과. 인증에 성공하면 ok, 실패하면 error
• reason (문자열): status가 error일 때만 포함되는 실패 원인. 계정이 존재하지 않으면 user-not-found, 암호가 일치하지 않으면 password-mismatch

오류 응답

필수 매개변수가 누락된 경우

HTTP 상태 코드 400 응답

{
  "error_code": "null-argument",
  "error_msg": "login should be not null"
}

계정이 존재하지 않는 경우

HTTP 상태 코드 200 응답

{
  "status": "error",
  "reason": "user-not-found"
}

암호가 일치하지 않는 경우

HTTP 상태 코드 200 응답

{
  "status": "error",
  "reason": "password-mismatch"
}

권한이 없는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "no-permission"
}