질의응답 조회 - ORIS API 문서

질의응답을 조회한다.

질의응답 조회 API는 GET 메소드로 호출되며, 상세 스펙 및 호출 예제는 아래와 같습니다.

요청메시지 URL

요청메시지 URL 표
HTTP URL	/api/oris/v1/threads/{threadId}
HTTP Method	GET

요청 메시지 명세

요청 메시지 명세
HTTP	항목	TYPE(길이)	필수	값	설명
Header	Authorization	string	Y	Bearer <access_token>	로그인 시 ORIS로부터 전송받은 access_token을 HTTP Header에 추가 [scope = inquiry]
Parameter	[inpath] threadId	integer(int64)	Y	1	질의응답ID

응답 메시지 명세

요청 메시지 명세
HTTP	항목	TYPE(길이)	필수	값	설명
Body	id	integer(int64)	Y	1	질의응답ID
	scope	string("PUBLIC" \| "AGENCY" \| "PRIVATE")	Y	PUBLIC	공개범위
	title	string(300)	Y	질의응답 제목	제목
	author	string	N	홍길동	작성자
	posts[]	array<object>	Y	-	답변 목록
	posts[].id	integer(int64)	Y	1	답변ID
	posts[].content	string	Y	답변 내용입니다.	답변 내용
	posts[].author	string	N	홍길동	작성자
	posts[].comments[]	array<object>	N	-	댓글 목록
	posts[].comments[].id	integer(int64)	Y	1	댓글ID
	posts[].comments[].text	string	Y	댓글 내용입니다.	댓글 내용
	posts[].comments[].author	string	N	홍길동	작성자
	posts[].comments[].createdAt	string(date-time)	N	2025-06-30T18:02:56.303340+09:00	생성일시
	posts[].comments[].modifiedAt	string(date-time)	N	2025-06-30T18:02:56.303340+09:00	수정일시
	posts[].comments[].editable	boolean	Y	true	수정 가능 여부
	posts[].files[]	array<object>	N	-	첨부파일 목록
	posts[].files[].fileId	integer(int64)	Y	1	첨부파일ID
	posts[].files[].fileName	string(500)	Y	첨부파일명	파일명
	posts[].files[].fileSize	integer(int64)	Y	1024	파일크기
	posts[].createdAt	string(date-time)	Y	2025-06-30T18:02:56.303340+09:00	생성일시
	posts[].modifiedAt	string(date-time)	Y	2025-06-30T18:02:56.303340+09:00	수정일시
	posts[].editable	boolean	Y	true	수정 가능 여부
	createdAt	string(date-time)	N	2025-06-30T18:02:56.303340+09:00	생성일시
	modifiedAt	string(date-time)	N	2025-06-30T18:02:56.303340+09:00	수정일시
	editable	boolean	Y	true	수정 가능 여부

응답 메시지 형태

{
  "id": 1,
  "scope": "PUBLIC",
  "title": "질의응답 제목",
  "author": "홍길동",
  "posts": [
    {
      "id": 1,
      "content": "답변 내용입니다.",
      "author": "홍길동",
      "comments": [
        {
          "id": 1,
          "text": "댓글 내용입니다.",
          "author": "홍길동",
          "createdAt": "2025-06-30T18:02:56.303340+09:00",
          "modifiedAt": "2025-06-30T18:02:56.303340+09:00",
          "editable": true
        }
      ],
      "files": [
        {
          "fileId": 1,
          "fileName": "첨부파일명",
          "fileSize": 1024
        }
      ],
      "createdAt": "2025-06-30T18:02:56.303340+09:00",
      "modifiedAt": "2025-06-30T18:02:56.303340+09:00",
      "editable": true
    }
  ],
  "createdAt": "2025-06-30T18:02:56.303340+09:00",
  "modifiedAt": "2025-06-30T18:02:56.303340+09:00",
  "editable": true
}

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

요청 메시지 명세
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"
}

인증 정보가 없는 경우 응답 메시지 형태(401)

{
  "code": "ACCESS_TOKEN_REQUIRED",
  "message": "Access token is required for authentication."
}

토큰 유효