공고 상세 정보 조회 v3

공고의 상세 정보를 불러옵니다.

신규 지원서 양식을 활용하는 공고 상세 조회입니다.

GET https://oapi.greetinghr.com/openapi/v2/openings/{openingId}

요청 URL이 변경되었으니, 참고 바랍니다.

X-Api-Version: 3.0

필드

타입

필수 여부

설명

파라미터 타입

openingId

Integer

필수

공고의 고유 번호(id) 입니다.

Path

필드

타입

필수 여부

설명

groupInfo

Object

필수

그리팅 내 워크스페이스 정보입니다.

openingInfo

Object

필수

그리팅 내 설정된 공고의 정보입니다.

docsInfo

Object[]

선택

그리팅 내 설정된 지원서류 정보입니다.

(참고) 신규 지원서로 전환된 이후 사라질 항목입니다. applicationForm 항목이 이 없는 경우에 활용해주세요.

questionnairesInfo

Object[]

필수

그리팅 내 설정된 사전질문 정보입니다.

(참고) 신규 지원서로 전환된 이후 사라질 항목입니다. applicationForm 항목이 없는 경우에 활용해주세요.

additionalApplicantInfoConfig

Object

선택

그리팅 내 설정된 추가정보 설정 정보입니다.

(참고) 신규 지원서로 전환된 이후 사라질 항목입니다. applicationForm 항목이 없는 경우에 활용해주세요.

openingJobPositionInfo

Object

선택

공고 모집분야 정보입니다.

termsInfo

Object

필수

동의서 정보입니다.

applicationForm

Object

선택

그리팅 내 설정된 지원서 설정 정보입니다.

해당 정보의 유/무에 따라 신규 공고/구 공고로 나뉩니다.

필드

타입

필수 여부

설명

groupId

Integer

필수

워크스페이스 id 입니다.

name

String

필수

워크스페이스 이름입니다.

imageUrl

String

선택

워크스페이스 프로필 URL 입니다.

필드

타입

필수 여부

설명

openingId

Integer

필수

공고 id 입니다.

title

String

필수

공고 제목입니다.

detail

String

선택

공고 상세 설명입니다. (html 형식)

openDate

String

선택

공고 생성일입니다.

ISO 8601 (UTC+0)

ex:2026-01-01T00:00:00Z

dueDate

String

선택

공고 마감일입니다.

ISO 8601 (UTC+0)

ex:2026-01-01T00:00:00Z

deploy

Boolean

필수

공고 채용사이트 게시 여부입니다.

subsidiary

String

선택

공고 구분값입니다.

필드

타입

필수 여부

설명

docId

String

필수

지원서류 id 입니다.

name

String

필수

지원서류 이름입니다.

detail

String

필수

지원서류 상세 설명입니다.

need

Boolean

필수

지원서류 필수 제출 여부입니다.

forms

Object[]

필수

지원서류 양식 파일 정보입니다.

enableUrl

Boolean

필수

지원서류 링크 제출 허용 여부입니다.

필드

타입

필수 여부

설명

fileName

String

필수

양식 파일명입니다.

fileType

String

필수

양식 파일 확장자명입니다.

fileSize

String

필수

양식 파일 파일크기입니다.

formUrl

String

필수

양식 파일 다운로드 URL입니다.

필드

타입

필수 여부

설명

questionnaireId

String

필수

사전 질문 id 입니다.

question

String

선택

사전 질문입니다.

type

Integer

선택

사전 질문 유형입니다.

  • 100 : 텍스트 입력

  • 200 : 단건 선택

  • 300 : 복수 선택

  • 400 : 지원 경로 입력

need

Boolean

선택

사전 질문 필수 제출 여부입니다.

description

String

선택

사전 질문 상세 설명입니다.

maxLength

Integer

선택

사전 질문 최대 답변 길이입니다.

items

String[]

필수

사전 질문 선택지입니다.

isDirectly

Boolean

필수

사전 질문 직접 등록 가능 여부입니다.

필드

타입

필수 여부

설명

gender

Enum

선택

성별 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함

  • OPTIONAL : 선택

  • REQUIRED : 필수

genderNotice

String

선택

성별 제출 유의사항입니다.

birthday

Enum

선택

생년월일 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함

  • OPTIONAL : 선택

  • REQUIRED : 필수

birthdayNotice

String

선택

생년월일 제출 유의사항입니다.

educationalBackground

Enum

선택

학력 사항 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함

  • OPTIONAL : 선택

  • REQUIRED : 필수

educationalBackgroundNotice

String

선택

학력 사항 제출 유의사항입니다.

career

Enum

선택

경력 사항 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함

  • OPTIONAL : 선택

  • REQUIRED : 필수

careerNotice

String

선택

경력 사항 제출 유의사항입니다.

languageSkill

Enum

선택

어학 사항 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함

  • OPTIONAL : 선택

  • REQUIRED : 필수

languageSkillNotice

String

선택

어학 사항 제출 유의사항입니다.

certificate

Enum

선택

자격증 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함

  • OPTIONAL : 선택

  • REQUIRED : 필수

certificateNotice

String

선택

자격증 제출 유의사항입니다.

militaryService

Enum

선택

병역 사항 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함

  • OPTIONAL : 선택

  • REQUIRED : 필수

militaryServiceNotice

String

선택

병역 사항 제출 유의사항입니다.

disability

Enum

선택

장애 사항 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함

  • OPTIONAL : 선택

  • REQUIRED : 필수

disbailityNotice

String

선택

장애 사항 제출 유의사항입니다.

veteranStatus

Enum

선택

보훈 사항 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함

  • OPTIONAL : 선택

  • REQUIRED : 필수

veteranStatusNotice

String

선택

보훈 사항 제출 유의사항입니다.

address

Enum

선택

주소 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함

  • OPTIONAL : 선택

  • REQUIRED : 필수

addressNotice

String

선택

주소 제출 유의사항입니다.

foreignName

Enum

선택

영문 이름 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함

  • OPTIONAL : 선택

  • REQUIRED : 필수

foreignNameNotice

String

선택

영문 제출 유의사항입니다.

nationality

Enum

선택

국적 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함

  • OPTIONAL : 선택

  • REQUIRED : 필수

natilnalityNotice

String

선택

국적 제출 유의사항입니다.

overseasExperience

Enum

선택

해외 경험 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함

  • OPTIONAL : 선택

  • REQUIRED : 필수

overseasExperienceNotice

String

선택

해외 경험 제출 유의사항입니다.

outsideActivity

Enum

선택

외부 활동 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함

  • OPTIONAL : 선택

  • REQUIRED : 필수

outsideActivityNotice

String

선택

외부 활동 제출 유의사항입니다.

profileImage

Enum

선택

프로필 사진 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함

  • OPTIONAL : 선택

  • REQUIRED : 필수

profileImageNotice

String

선택

프로필 사진 제출 유의사항입니다.

필드

타입

필수 여부

설명

openingJobPositionSetting

Object

필수

공고 모집분야 설정 정보입니다.

openingJobPositions

List

필수

지원자가 선택 가능한 모집분야 값 리스트입니다.

필드

타입

필수 여부

설명

id

Integer

필수

공고 모집분야 설정 정보 고유 id입니다.

maxPriority

Integer

필수

선택 가능한 모집분야의 최대 갯수입니다.

openingId

Integer

필수

공고의 고유 id입니다.

createdAt

String

필수

공고 모집분야 설정 정보 생성일입니다.

ISO 8601 (UTC+0)

ex:2026-01-01T00:00:00Z

updatedAt

String

필수

공고 모집분야 설정 정보 수정일입니다.

ISO 8601 (UTC+0)

ex:2026-01-01T00:00:00Z

필드

타입

필수 여부

설명

id

Integer

필수

지원자가 선택 가능한 모집분야 값 고유 id입니다.

openingId

Integer

필수

공고의 고유 id입니다.

jobPositionPlace

Object

선택

지원자가 선택 가능한 근무지입니다.

jobPositionField

Object

선택

지원자가 선택 가능한 부입니다.

jobPositionOccupation

Object

선택

지원자가 선택 가능한 직군입니다.

jobPositionJob

Object

선택

지원자가 선택 가능한 직무입니다.

jobPositionCareer

Object

선택

지원자가 선택 가능한 경력 사항 입니다.

jobPositionEmployment

Object

선택

지원자가 선택 가능한 채용 형태 입니다.

필드

타입

필수 여부

설명

id

Integer

필수

부문 고유 id입니다.

field

String

필수

부문입니다.

workspaceId

Integer

필수

워크스페이스 ID입니다.

필드

타입

필수 여부

설명

id

Integer

필수

직군 고유 id입니다.

occupation

String

필수

직군입니다.

workspaceId

Integer

필수

워크스페이스 ID입니다.

필드

타입

필수 여부

설명

id

Integer

필수

직무 고유 id입니다.

job

String

필수

직무입니다.

workspaceId

Integer

필수

워크스페이스 ID입니다.

필드

타입

필수 여부

설명

id

Integer

필수

근무지 고유 id입니다.

location

String

필수

근무 지역입니다.

place

String

선택

기본 주소입니다.

detailPlace

String

선택

상세 주소입니다.

geo

String

선택

위,경도 값입니다.

geo.lat

BigDecimal

필수

위도

geo.lng

BigDecimal

필수

경도

mapApi

String

선택

Google Map 제공 id입니다.

mapApi.placeId

String

필수

provider에서 제공하는 ID값입니다.

mapApi.provider

String

필수

GOOGLE

workFromHome

Boolean

선택

재택 근무 가능 여부입니다.

workspaceId

Integer

필수

워크스페이스 ID입니다.

필드

타입

필수 여부

설명

id

Integer

필수

경력사항 고유 id입니다.

careerFrom

Integer

선택

최소 경력 연수입니다.

careerTo

Integer

선택

최대 경력 연수입니다.

careerType

Enum

선택

경력 사항 구분입니다.

openingId

Integer

필수

공고의 고유 id입니다.

openingJobPositionId

Integer

필수

지원자가 선택 가능한 모집분야 값 고유 id입니다.

createdAt

String

필수

공고 모집분야 설정 정보 생성일입니다.

ISO 8601 (UTC+0)

ex:2026-01-01T00:00:00Z

updatedAt

String

필수

공고 모집분야 설정 정보 수정일입니다.

ISO 8601 (UTC+0)

ex:2026-01-01T00:00:00Z

필드

타입

필수 여부

설명

id

Integer

필수

채용 형태 고유 id입니다.

employment

Enum

필수

채용 형태입니다.

  • FULL_TIME_WORKER: 정규

  • CONTRACT_WORKER: 계약직

  • INTERN_WORKER: 인턴

  • FREE_LANCER: 프리랜서

  • MILITARY_SERVICE_EXCEPTION: 병역 특례

openingId

Integer

필수

공고의 고유 id입니다.

openingJobPositionId

Integer

필수

지원자가 선택 가능한 모집분야 값 고유 id입니다.

createdAt

String

필수

공고 모집분야 설정 정보 생성일입니다.

ISO 8601 (UTC+0)

ex:2026-01-01T00:00:00Z

updatedAt

String

필수

공고 모집분야 설정 정보 수정일입니다.

ISO 8601 (UTC+0)

ex:2026-01-01T00:00:00Z

필드

타입

필수 여부

설명

personalRequiredTerm

Object

선택

개인정보 필수항목 수집 및 이용 동의서에 대한 정보입니다.

personalOptionalTerm

Object

선택

개인정보 선택항목 수집 및 이용 동의서에 대한 정보입니다.

sensitiveTerm

Object

선택

민감정보 수집 및 이용 동의서에 대한 정보입니다.

customTerms

Object[]

필수

범용영역 동의서에 대한 정보입니다.

필드

타입

필수 여부

설명

id

Number

필수

동의서 id

isRequired

Boolean

필수

동의서 필수/선택 여부

locales

Object

필수

동의서 언어

필드

타입

필수 여부

설명

ko

Object

필수

한글 언어 동의서에 대한 정보

en

Object

필수

영문 언어 동의서에 대한 정보

필드

타입

필수 여부

설명

title

String

필수

동의서 제목

content

String

필수

동의서 내용

필드

타입

필수 여부

설명

id

Long

필수

지원서 ID입니다.

guideLine

Object(MultiLanguage)

선택

지원서의 상단 가이드입니다

latestSnapshotKey

String

선택

API 응답 시점의 가장 최근 스냅샷 키 입니다. 지원자 등록 API 호출 시 applicationFormSnapshotKey 항목에 해당 정보를 함께 전달해야 합니다.

categories

Object[]

필수

지원서의 카테고리입니다.

createdAt

String

필수

지원서의 생성일입니다.

ISO 8601 (UTC+0)

ex:2026-01-01T00:00:00Z

updatedAt

String

필수

지원서의 수정일입니다.

ISO 8601 (UTC+0)

ex:2026-01-01T00:00:00Z

필드

타입

필수 여부

설명

ko

String

필수

항목의 한글값입니다.

en

String

선택

항목의 영문값입니다.

필드

타입

필수 여부

설명

id

Long

필수

카테고리 ID입니다.

categoryType

String

필수

카테고리 타입입니다.

지원서 설정 타입

title

Object(MultiLanguage)

필수

카테고리명입니다.

components

Object[]

필수

카테고리에 속한 컴포넌트입니다.

createdAt

String

필수

카테고리의 생성일입니다.

ISO 8601 (UTC+0)

ex:2026-01-01T00:00:00Z

updatedAt

String

필수

카테고리의 수정일입니다.

ISO 8601 (UTC+0)

ex:2026-01-01T00:00:00Z

필드

타입

필수 여부

설명

id

Long

필수

컴포넌트 ID입니다.

componentType

String

필수

컴포넌트 타입입니다.

지원서 설정 타입

title

Object(MultiLanguage)

필수

컴포넌트명입니다.

isRequired

Boolean

필수

컴포넌트의 필수여부입니다.

guideLine

String

선택

컴포넌트의 상단 가이드입니다.

multipleType

String

필수

컴포넌트 단일/복합 여부입니다.

하위 어트리뷰트 속성의 개수가 2개 이상일 경우, 복합 컴포넌트가 됩니다.

attributes

Object[]

필수

컴포넌트에 속한 어트리뷰트입니다.

createdAt

String

필수

컴포넌트의 생성일입니다.

ISO 8601 (UTC+0)

ex:2026-01-01T00:00:00Z

updatedAt

String

필수

컴포넌트의 수정일입니다.

ISO 8601 (UTC+0)

ex:2026-01-01T00:00:00Z

필드

타입

필수 여부

설명

id

Long

필수

어트리뷰트 ID입니다.

attributeType

String

필수

어트리뷰트 타입입니다.

지원서 설정 타입

title

Object(MultiLanguage)

필수

어트리뷰트명입니다.

isRequired

Boolean

필수

어트리뷰트의 필수여부입니다.

dateType

String

선택

(옵션 구성 항목)

날짜범위입니다.

  • YM, YMD

defaultCountryCode

Integer

선택

(옵션 구성 항목)

국가 기본값입니다.

maximumLength

Integer

선택

(옵션 구성 항목)

최대 글자수입니다.

useCompanyPolicy

Boolean

선택

(옵션 구성 항목)

회사 내규에 따름 옵션입니다.

isAllowUrl

Boolean

선택

(옵션 구성 항목)

URL 제출 허용 여부입니다.

guideFile

Object[]

필수

(옵션 구성 항목)

가이드 양식 파일 정보입니다.

guideFile.fileName

String

필수

가이드 양식 파일의 이름입니다.

guideFile.fileDownloadUrl

String

필수

가이드 양식 파일의 다운로드 URL입니다.

guideFile.fileSize

Long

필수

가이드 양식 파일의 용량입니다.

isCustomInput

Boolean

선택

(옵션 구성 항목)

직접 입력 가능 여부입니다.

optionList

Object[]

선택

(옵션 구성 항목)

옵션 리스트 목록입니다.

optionList.id

String

필수

옵션 항목의 고유 ID입니다.

optionList.name

Object(MultiLanguage)

필수

옵션 항목명입니다.

createdAt

String

필수

어트리뷰트의 생성일입니다.

ISO 8601 (UTC+0)

ex:2026-01-01T00:00:00Z

updatedAt

String

필수

어트리뷰트의 수정일입니다.

ISO 8601 (UTC+0)

ex:2026-01-01T00:00:00Z

JSON