Rest API 공통

Rest API Result

모든 Rest API 호출은 다음과 같은 json 형태를 가진다.

{
  "status": "OK",
  "success": true,
  "version": "1",
  "error": null,
  "data": []
}
속성명 설명 값 예시
success API 호출 성공 여부
status API 호출에 대한 상 OK, INTERNAL_SERVER_ERROR, 등
version API 버젼 1
error 호출이 실패했을 경우에 설정되는 에러 정보 하단 에러 정보 참조
data 호출이 성공했을 경우에 설정되는 결과 값 각 API 문서 참조

실패 에러 정보

success 가 false 일 경우 error 속성에 다음과 같이 설정된다.

{
  ...
  "error": {
    "type": "AUTHENTICATION",
    "code": "INVALIDATE_ACCESS_TOKEN",
    "message": "인증토근이 유효하지 않습니다.",
    "errorStack": null
  }
  ...
}

type 에 따라 적절한 에러처리를 하도록한다.

type description
AUTHENTICATION 인증 관련
INVALIDATE_INPUT API 입력에 필요한 파라미터가 잘못된 경우, 클라이언트 에러 처리 필요
MESSAGE 사용자 액션 처리 오류. message 값을 사용자에게 출력한다
UNKNOWN 알 수 없는 서버 오류. 클라이언트에서는 서버 오류 발생에 대한 사용자에게 에러 안내조치를 시행한다

type 이 'AUTHENTICATION' 일 경우에 발생가능한 코드

code description
INCORRECT_LOGIN_ID_AND_PASSWORD 로그인 ID 와 패스워드가 일치하지 않을 경우, IDP 로그인 실패시에 발생
INVALIDATE_ACCESS_TOKEN 인증토큰이 옳바르지 않은 경우. 클라이언트 에러 처리
EXPIRED_ACCESS_TOKEN 인증토큰이 만료됨. 다시 로그인 화면을 유도해야한다
NO_PERMISSION 해당 API 를 수행할 권한이 없음

type 이 'INVALIDATE_INPUT' 일 경우에 발생가능한 코드

code description
ALREADY_KAKAO_ACCOUNT_REGISTER 카카오토큰으로 가입 요청시 해당 카카오토큰으로 이미 카카오 등록된 경우
REQUIRED_PARAMETER 필수 파라미터 누락
NOT_FOUND API 수행에 필요한 대상이 존재하지 않음

type 이 'MESSAGE' 일 경우에 발생가능한 코드

code description
DUPLICATE_LOGIN_ID IDP 로 회원가입시 이미 가입된 LOGIN_ID 가 있을 경우
DUPLICATE_CODE 코드 등록시 이미 등록된 코드가 있을 경우
SET_PARENT_TO_CHILDREN_ON_CATEGORY 트리에서 대상을 이동할 때, 대상의 자손으로 이동을 시도한 경우

type 이 'UNKNOWN' 일 경우에 발생가능한 코드

code description
UNKNOWN_SERVER_ERROR 알 수 없는 서버 오류. 사용자에겐 graceful 하게 에러 안내를 시행한다

results matching ""

    No results matching ""