관리자/담당자 로그인

API 호출을 위한 access token을 발급한다.

관리자/담당자 로그인 API는 POST 메소드로 호출되며, 상세 스펙 및 호출 예제는 아래와 같습니다.

요청메시지 URL

요청메시지 URL 표
HTTP URL	/api/oris/v1/login
HTTP Method	POST
Content-Type	application/json; charset=UTF-8

요청 메시지 명세

요청 메시지 명세
HTTP	항목	TYPE(길이)	필수	값	설명
Body	id	string(100)	Y	[email protected]	로그인 아이디
Body	password	string(100)	Y	123456	로그인 비밀번호

요청 메시지 형태

{
  "id": "[email protected]",
  "password": "123456"
}

응답 메시지 명세

요청 메시지 명세
HTTP	항목	TYPE(길이)	필수	값	설명
Body	accessType	string("MEMBER" \| "API")	Y	MEMBER	인증타입
	accessSubjectId	string(26)	Y	01JPPDAFTSNPNF0196AW7TQNS8	인증주체ID
	accessToken	string(2000)	Y	eyJhbGciOiJFUzI1NiJ9.eyJqdGkiOiIxIiwiYWNjZXNzVHlwZSI6Ik1FTUJFUiIsImFjY2Vzc1N1YklkIjoxLCJhZ2VuY3lJZCI6MSwicGVybWlzc2lvbnMiOiJbXCJTVVBFUlwiXSIsImlhdCI6MTczMzQ2MDI1NiwiZXhwIjoxNzMzNDYwODU2fQ.CDLdcKF-xa4sF2Eks3rngzuOwxu66WU8DIpgtWhfn947zepC6s7-fwS0B1QG_pIH6Q6GhD08qkDvXcl1BXa5ug	접근토큰
	refreshToken	string(2000)	Y	eyJhbGciOiJFUzI1NiJ9.eyJqdGkiOiIxIiwiYWNjZXNzVHlwZSI6Ik1FTUJFUiIsImFjY2Vzc1N1YklkIjoxLCJhZ2VuY3lJZCI6MSwiaWF0IjoxNzMzNDYwMjU2LCJleHAiOjE3MzM0NjM4NTZ9.cmbnMju1YuTeJowIAzJcvk6K60GuYJ0lwcEWTO0RxPSZTc4unum5PKYwnXsqjlHWBZzAUdYyrdivkvk-iAADQQ	갱신토큰

응답 메시지 형태

{
  "accessType": "MEMBER",
  "accessSubjectId": "01JPPDAFTSNPNF0196AW7TQNS8",
  "accessToken": "eyJhbGciOiJFUzI1NiJ9.eyJqdGkiOiIxIiwiYWNjZXNzVHlwZSI6Ik1FTUJFUiIsImFjY2Vzc1N1YklkIjoxLCJhZ2VuY3lJZCI6MSwicGVybWlzc2lvbnMiOiJbXCJTVVBFUlwiXSIsImlhdCI6MTczMzQ2MDI1NiwiZXhwIjoxNzMzNDYwODU2fQ.CDLdcKF-xa4sF2Eks3rngzuOwxu66WU8DIpgtWhfn947zepC6s7-fwS0B1QG_pIH6Q6GhD08qkDvXcl1BXa5ug",
  "refreshToken": "eyJhbGciOiJFUzI1NiJ9.eyJqdGkiOiIxIiwiYWNjZXNzVHlwZSI6Ik1FTUJFUiIsImFjY2Vzc1N1YklkIjoxLCJhZ2VuY3lJZCI6MSwiaWF0IjoxNzMzNDYwMjU2LCJleHAiOjE3MzM0NjM4NTZ9.cmbnMju1YuTeJowIAzJcvk6K60GuYJ0lwcEWTO0RxPSZTc4unum5PKYwnXsqjlHWBZzAUdYyrdivkvk-iAADQQ"
}

에러인 경우 응답 메시지 명세

요청 메시지 명세
HTTP	항목	TYPE(길이)	필수	값	설명
Body	message	string	N	요청에 실패했습니다.	오류 메시지
Body	code	string("ERROR" \| "BAD_REQUEST" \| "INVALID_REQUEST" \| "UNAUTHORIZED" \| "FORBIDDEN" \| "ACCESS_TOKEN_REQUIRED" \| "ACCESS_TOKEN_EXPIRED" \| "ACCESS_TOKEN_INVALID" \| "ACCESS_TOKEN_NOT_ENOUGH_PERMISSION" \| "AGENCY_NOT_FOUND" \| "AGENCY_NOT_ACTIVE" \| "AGENCY_NOT_APPROVED" \| "AGENCY_NOT_MATCH" \| "AGENCY_ACCESS_DENIED" \| "AGENCY_CODE_DUPLICATED" \| "MEMBER_NOT_FOUND" \| "MEMBER_NOT_ACTIVE" \| "MEMBER_NOT_MATCH" \| "MEMBER_PASSWORD_NOT_MATCH" \| "MEMBER_EMAIL_DUPLICATED" \| "MEMBER_PASSWORD_RESET" \| "MEMBER_PASSWORD_RESET_WITH_OLD" \| "MEMBER_PASSWORD_INVALID_FORMAT" \| "MEMBER_PASSWORD_FAIL_LIMIT_EXCEEDED" \| "MEMBER_PASSWORD_EXPIRED" \| "MEMBER_ACCOUNT_LOCKED" \| "MEMBER_PASSWORD_REUSED" \| "MEMBER_ACCESS_DENIED" \| "API_KEY_NOT_FOUND" \| "USER_NOT_FOUND" \| "USER_NOT_ACTIVE" \| "ACCOUNT_NOT_FOUND" \| "REMITTANCE_NOT_FOUND" \| "REMITTANCE_ALREADY_EXISTS" \| "REMITTANCE_ALREADY_CANCELED" \| "REMITTANCE_ACCOUNT_YEAR_MISMATCH" \| "THREAD_NOT_FOUND" \| "THREAD_ACCESS_DENIED" \| "POST_NOT_FOUND" \| "POST_ACCESS_DENIED" \| "COMMENT_NOT_FOUND" \| "COMMENT_ACCESS_DENIED" \| "FILE_NOT_FOUND" \| "FILE_ACCESS_DENIED" \| "FILE_ALREADY_ATTACHED" \| "FILE_DELETE_FAILED" \| "TERM_NOT_FOUND" \| "TERM_CANNOT_UPDATE" \| "TERM_CANNOT_DELETE" \| "TERM_CANNOT_SET_INITIATION_DATE" \| "TERM_CANNOT_WITHDRAW_INITIATION_DATE" \| "TERM_TYPE_NOT_FOUND" \| "CONSENT_REQUIRED" \| "CONSENT_NOT_FOUND" \| "CONSENT_NOT_MATCH" \| "GROUP_NOT_FOUND" \| "GROUP_UPDATE_FORBIDDEN" \| "GROUP_DELETE_FORBIDDEN" \| "BATCH_NOT_FOUND" \| "BATCH_CHUNK_NOT_FOUND")	N	ERROR	오류 코드

요청값이 제약 조건에 위반되는 경우 응답 메시지 형태(400)

{
  "code": "BAD_REQUEST",
  "message": "Failed to convert value of type 'java.lang.String' to required type 'java.lang.Boolean'"
}

메소드 인자 타입이 일치하지 않는 경우 응답 메시지 형태(400)

{
  "code": "BAD_REQUEST",
  "message": "Failed to convert value of type 'java.lang.String' to required type 'java.lang.Boolean'"
}

메소드 인자 검증 실패한 경우 응답 메시지 형태(400)

{
  "code": "BAD_REQUEST",
  "message": "Validation failed for argument at index 0 in method"
}

json 형식이 잘못된 경우 응답 메시지 형태(400)

{
  "code": "BAD_REQUEST",
  "message": "Malformed JSON request"
}

요청값이 잘못된 경우 응답 메시지 형태(400)

{
  "code": "BAD_REQUEST",
  "message": "Invalid argument"
}

요청한 URL에 맞는 핸들러를 찾을 수 없는 경우 응답 메시지 형태(404)

{
  "code": "BAD_REQUEST",
  "message": "No handler found for the request"
}

서버 에러인 경우 응답 메시지 형태(500)

{
  "code": "ERROR",
  "message": "Internal server error. Please try again later."
}