Access Token 검증

Access Token 검증 API는 POST 메소드로 호출되며, 상세 스펙 및 호출 예제는 아래와 같습니다.

URL 요청메시지 URL

HTTP URL /api/oris/v1/auth/validate
HTTP Method
POST
Content-Type application/json; charset=UTF-8

요청 메시지 명세

HTTP 항목 TYPE(길이) 필수 값 설명
Body token string(2000) Y - 인증토큰

요청 메시지 형태

{
  "token": "string"
}

응답 메시지 명세

HTTP 항목 TYPE(길이) 필수 값 설명
Body header string Y {kid=oris-es256-key-1, alg=ES256} JWT 헤더
payload string Y {jti=01K0S9JDCA41ZTTTTQT380KR13, accessType=MEMBER, ...} JWT 페이로드
subject string N - 토큰의 발급 주체
issuer string N - 토큰의 발급자
expiration string(date-time) Y 2025-07-22T23:55:58.000+09:00 Token 만료일시

응답 메시지 형태

{
  "header": "{kid=oris-es256-key-1, alg=ES256}",
  "payload": "{jti=01K0S9JDCA41ZTTTTQT380KR13, ...}",
  "subject": "string",
  "issuer": "string",
  "expiration": "2025-07-22T23:55:58.000+09:00"
}

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

HTTP 항목 TYPE(길이) 필수 값 설명
Body message string N 요청에 실패했습니다. 오류 메시지
code string(enum) N ERROR 오류 코드

요청값이 제약 조건에 위반되는 경우 (400)

{
  "code": "BAD_REQUEST",
  "message": "Failed to convert value..."
}

메소드 인자 타입이 일치하지 않는 경우 (400)

{
  "code": "BAD_REQUEST",
  "message": "Failed to convert value..."
}

메소드 인자 검증 실패한 경우 (400)

{
  "code": "BAD_REQUEST",
  "message": "Validation failed..."
}

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."
}