기업을 위한 그리팅 가이드

공고 전체 리스트 조회

그리팅 내 공고들의 정보를 불러옵니다.

요청 URL

GET https://oapi.greetinghr.com/openapi/openings

요청 헤더

X-Api-Version: 2.0

요청 파라미터

필드

타입

필수 여부

파라미터 타입

비고

page

Integer

필수

Query

페이지는 0부터 시작합니다.

pageSize

Integer

필수

Query

title

String

선택

Query

occupation

List<String>

선택

Query

field

List<String>

선택

Query

job

List<String>

선택

Query

place

List<String>

선택

Query

employmentType

List<Enum>

선택

Query

  • FULL_TIME_WORKER: 정규직

  • CONTRACT_WORKER: 계약직

  • INTERN_WORKER: 인턴

  • FREE_LANCER: 프리랜서

  • MILITARY_SERVICE_EXCEPTION: 병역특례

careerType

List<Enum>

선택

Query

  • NEW_COMER: 신입

  • EXPERIENCED: 경력

  • NOT_MATTER: 무관

activatedAtCareerPage

Boolean

선택

Query

해당 요청 파라미터는 삭제 예정입니다.

status

Enum

선택

Query

  • OPEN: 활성화

  • CLOSE: 비활성화

  • ARCHIVE: 보관함

응답 객체

필드

타입

필수 여부

설명

id

Integer

필수

title

String

필수

dueDate

String

선택

url

String

필수

activatedAtCareerPage

Boolean

필수

openingJobPositionInfo

Object

선택

응답객체 상세(openingJobPositionInfo)

필드

타입

필수 여부

설명

openingJobPositionSetting

Integer

필수

openingJobPositions

String

필수

응답객체 상세(openingJobPositionSetting)

필드

타입

필수 여부

설명

id

Integer

필수

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

maxPriority

Integer

필수

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

openingId

Integer

필수

공고의 고유 id입니다.

createdAt

String

필수

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

updatedAt

String

필수

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

응답객체 상세(openingJobPositions)

필드

타입

필수 여부

설명

id

Integer

필수

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

openingId

Integer

필수

공고의 고유 id입니다.

jobPositionPlace

Object

선택

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

jobPositionField

Object

선택

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

jobPositionOccupation

Object

선택

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

jobPositionJob

Object

선택

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

jobPositionCareer

Object

선택

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

jobPositionEmployment

Object

선택

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

응답 객체 상세 (jobPositionField)

필드

타입

필수 여부

설명

id

Integer

필수

부문 고유 id입니다.

field

String

필수

부문입니다.

openingId

Integer

필수

공고의 고유 id입니다.

openingJobPositionId

Integer

필수

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

createdAt

String

필수

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

updatedAt

String

필수

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

응답 객체 상세 (jobPositionOccupation)

필드

타입

필수 여부

설명

id

Integer

필수

직 고유 id입니다.

occupation

String

필수

직군입니다.

openingId

Integer

필수

공고의 고유 id입니다.

openingJobPositionId

Integer

필수

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

createdAt

String

필수

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

updatedAt

String

필수

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

응답 객체 상세 (jobPositionJob)

필드

타입

필수 여부

설명

id

Integer

필수

직 고유 id입니다.

job

String

필수

직무입니다.

openingId

Integer

필수

공고의 고유 id입니다.

openingJobPositionId

Integer

필수

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

createdAt

String

필수

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

updatedAt

String

필수

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

응답 객체 상세 (jobPositionPlace)

필드

타입

필수 여부

설명

id

Integer

필수

근무지 고유 id입니다.

location

String

필수

근무 지역입니다.

googleMapId

String

선택

Google Map 제공 id입니다.

place

String

선택

기본 주소입니다.

detailPlace

String

선택

상세 주소입니다.

workFromHome

Boolean

선택

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

openingId

Integer

필수

공고의 고유 id입니다.

openingJobPositionId

Integer

필수

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

createdAt

String

필수

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

updatedAt

String

필수

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

응답 객체 상세 (jobPositionCareer)

필드

타입

필수 여부

설명

id

Integer

필수

경력사항 고유 id입니다.

careerFrom

Integer

선택

최소 경력 연수입니다.

careerTo

Integer

선택

최대 경력 연수입니다.

careerType

Enum

선택

경력 사항 구분입니다.

openingId

Integer

필수

공고의 고유 id입니다.

openingJobPositionId

Integer

필수

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

createdAt

String

필수

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

updatedAt

String

필수

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

응답 객체 상세 (jobPositionEmployment)

필드

타입

필수 여부

설명

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

필수

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

updatedAt

String

필수

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

예시 응답

JSON