그리팅 ATS 가이드
API 문서
문의하기그리팅 TRM 가이드그리팅 홈페이지

공고 전체 리스트 조회

📘

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

요청 URL

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


요청 헤더

X-Api-Version: 2.0


요청 파라미터

필드타입필수 여부설명파라미터 타입
pageInt필수페이지 번호입니다. 0부터 시작합니다.Query
pageSizeInt필수페이지 당 반환되는 데이터의 갯수입니다. 최대 100개로 제한됩니다.Query
titleString선택검색하고자 하는 공고의 제목입니다.Query
occupationList선택검색하고자 하는 공고의 직군입니다. 여러개를 or 조건으로 검색할 수 있습니다.Query
fieldList선택검색하고자 하는 공고의 부문입니다. 여러개를 or 조건으로 검색할 수 있습니다.Query
jobList선택검색하고자 하는 공고의 직무입니다. 여러개를 or 조건으로 검색할 수 있습니다.Query
placeList직선택검색하고자 하는 공고의 직무입니다. 여러개를 or 조건으로 검색할 수 있습니다.Query
employmentList

- FULL_TIME_WORKER:정규
직
- CONTRACT_WORKER: 계약
직
- INTERN_WORKER : 인
턴
- FREE_LANCER : 프리랜
서
- MILITARY_SERVICE_EXCEPTION : 병역특례		선택검색하고자 하는 공고의 채용 형태입니다. 여러개를 or 조건으로 검색할 수 있습니다.Query
careerList

- NEW_COMER : 신입
- EXPERIENCED : 경력
- NOT_MATTER : 무관		선택검색하고자 하는 공고의 경력사항 정보입니다.Query
activatedAtCareerPageBoolean선택검색하고자 하는 공고의 채용 사이트 게시 여부입니다.

- true 로 전달 시 채용 사이트에 게시된 공고만 불러옵니다.
- false 로 전달 시 채용 사이트에 게시되지 않은 공고만 불러옵니다.		Query
statusEnum

- OPEN: 활성
화
- CLOSE : 비활성
화
- ARCHIVE : 보관함		선택검색하고자 하는 공고의 상태입니다.Query

예시 응답

{
  "success": true,
  "data": {
     "page": 0,
     "pageSize": 10,
     "totalCount": 1,
     "totalPage": 0,
     "hasPrev": false,
     "hasNext": false,
     "datas": [{
       "id": 1,
       "title": "채용 공고",
       "dueDate": "2022-01-01T00:00:00.000Z",
       "url": "career.doodlin.co.kr/o/1",
       "activatedAtCareerPage": true,
       "openingJobPositionInfo": {
        	"openingJobPositionSetting": {
            "id": 1,
            "maxPriority": 3,
            "openingId": 1,
            "createdAt": "2022-01-01T00:00:00.000Z",
            "updatedAt": "2022-01-01T00:00:00.000Z",
          },
         "openingJobPositions": [
           {
             "id": 1,
             "openingId": 1,
             "jobPositionField": {
               "id": 1,
               "field": "부문",
               "openingId": 1,
               "openingJobPositionId": 1,
               "createdAt": "2022-01-01T00:00:00.000Z",
               "updatedAt": "2022-01-01T00:00:00.000Z",
             },
             "jobPositionOccupation": {
               "id": 1,
               "occupation": "직군",
               "openingId": 1,
               "openingJobPositionId": 1,
               "createdAt": "2022-01-01T00:00:00.000Z",
               "updatedAt": "2022-01-01T00:00:00.000Z",
             },
             "jobPositionJob": {
               "id": 1,
               "job": "직무",
               "openingId": 1,
               "openingJobPositionId": 1,
               "createdAt": "2022-01-01T00:00:00.000Z",
               "updatedAt": "2022-01-01T00:00:00.000Z",
             },
             "jobPositionPlace": {
               "id": 1,
               "googleMapId": "id",
               "location": "서울",
               "place": "서울특별시 강남구",
               "detailPlace": "강남대로",
               "workFromHome": true,
               "openingId": 1,
               "openingJobPositionId": 1,
               "createdAt": "2022-01-01T00:00:00.000Z",
               "updatedAt": "2022-01-01T00:00:00.000Z",
             },
             "jobPositionCareer": {
               "id": 1,
               "careerFrom": 0,
               "careerTo": 3,
               "careerType": "EXPERIENCED",
               "openingId": 1,
               "openingJobPositionId": 1,
               "createdAt": "2022-01-01T00:00:00.000Z",
               "updatedAt": "2022-01-01T00:00:00.000Z",
             },
             "jobPositionEmployment": {
               "id": 1,
               "employment": "FULL_TIME_WORKER",
               "openingId": 1,
               "openingJobPositionId": 1,
               "createdAt": "2022-01-01T00:00:00.000Z",
               "updatedAt": "2022-01-01T00:00:00.000Z",
             },
           }
         ],
       }
     }]
  },
 "message": null,
 "errorCode": null
}

응답 객체 상세 (datas)

필드타입필수 여부설명
idInteger필수공고의 고유 id입니다.
titleString필수공고의 제목입니다.
dueDateString선택공고의 마감일 정보입니다.
urlString필수공고의 링크입니다.
activatedAtCareerPageBoolean필수공고의 채용 사이트 게시 여부입니다.
openingJobPositionInfoObject선택공고 모집분야 정보입니다.

응답 객체 상세 (openingJobPositionInfo)

필드타입필수 여부설명
openingJobPositionSettingObject필수공고 모집분야 설정 정보입니다.
openingJobPositionsList필수지원자가 선택 가능한 모집분야 값 리스트입니다.

응답 객체 상세 (openingJobPositionSetting)

필드타입필수 여부설명
idInteger필수공고 모집분야 설정 정보 고유 id입니다.
maxPriorityInteger필수선택 가능한 모집분야의 최대 갯수입니다.
openingIdInteger필수공고의 고유 id입니다.
createdAtString필수공고 모집분야 설정 정보 생성일입니다.
updatedAtString필수공고 모집분야 설정 정보 수정일입니다.

응답 객체 상세 (openingJobPositions)

필드타입필수 여부설명
idInteger필수지원자가 선택 가능한 모집분야 값 고유 id입니다.
openingIdInteger필수공고의 고유 id입니다.
jobPositionPlaceObject선택지원자가 선택 가능한 근무지입니다.
jobPositionFieldObject선택지원자가 선택 가능한 부입니다.
jobPositionOccupationObject선택지원자가 선택 가능한 직군입니다.
jobPositionJobObject선택지원자가 선택 가능한 직무입니다.
jobPositionCareerObject선택지원자가 선택 가능한 경력 사항 입니다.
jobPositionEmploymentObject선택지원자가 선택 가능한 채용 형태 입니다.
createdAtString필수지원자가 선택 가능한 모집분야 값 생성일입니다.
updatedAtString필수지원자가 선택 가능한 모집분야 값 수정일입니다.

응답 객체 상세 (jobPositionField)

필드타입필수 여부설명
idInteger필수부문 고유 id입니다.
fieldString필수부문입니다.
openingIdInteger필수공고의 고유 id입니다.
openingJobPositionIdInteger필수지원자가 선택 가능한 모집분야 값 고유 id입니다.
createdAtString필수공고 모집분야 설정 정보 생성일입니다.
updatedAtString필수공고 모집분야 설정 정보 수정일입니다.

응답 객체 상세 (jobPositionOccupation)

필드타입필수 여부설명
idInteger필수직 고유 id입니다.
occupationString필수직군입니다.
openingIdInteger필수공고의 고유 id입니다.
openingJobPositionIdInteger필수지원자가 선택 가능한 모집분야 값 고유 id입니다.
createdAtString필수공고 모집분야 설정 정보 생성일입니다.
updatedAtString필수공고 모집분야 설정 정보 수정일입니다.

응답 객체 상세 (jobPositionJob)

필드타입필수 여부설명
idInteger필수직 고유 id입니다.
jobString필수직무입니다.
openingIdInteger필수공고의 고유 id입니다.
openingJobPositionIdInteger필수지원자가 선택 가능한 모집분야 값 고유 id입니다.
createdAtString필수공고 모집분야 설정 정보 생성일입니다.
updatedAtString필수공고 모집분야 설정 정보 수정일입니다.

응답 객체 상세 (jobPositionPlace)

필드타입필수 여부설명
idInteger필수근무지 고유 id입니다.
locationString필수근무 지역입니다.
googleMapIdString선택Google Map 제공 id입니다.
placeString선택기본 주소입니다.
detailPlaceString선택상세 주소입니다.
workFromHomeBoolean선택재택 근무 가능 여부입니다.
openingIdInteger필수공고의 고유 id입니다.
openingJobPositionIdInteger필수지원자가 선택 가능한 모집분야 값 고유 id입니다.
createdAtString필수공고 모집분야 설정 정보 생성일입니다.
updatedAtString필수공고 모집분야 설정 정보 수정일입니다.

응답 객체 상세 (jobPositionCareer)

필드타입필수 여부설명
idInteger필수경력사항 고유 id입니다.
careerFromInteger선택최소 경력 연수입니다.
careerToInteger선택최대 경력 연수입니다.
careerTypeEnum

- NEW_COMER: 신입
- EXPERIENCED : 경
력
- NOT_MATTER : 무관		선택경력 사항 구분입니다.
openingIdInteger필수공고의 고유 id입니다.
openingJobPositionIdInteger필수지원자가 선택 가능한 모집분야 값 고유 id입니다.
createdAtString필수공고 모집분야 설정 정보 생성일입니다.
updatedAtString필수공고 모집분야 설정 정보 수정일입니다.

응답 객체 상세 (jobPositionEmployment)

필드타입필수 여부설명
idInteger필수채용 형태 고유 id입니다.
employmentEnum

- FULL_TIME_WORKER: 정규
- CONTRACT_WORKER : 계약
직
- INTERN_WORKER : 인
턴
- FREE_LANCER : 프리랜
서
- MILITARY_SERVICE_EXCEPTION : 병역특례		필수채용 형태입니다.
openingIdInteger필수공고의 고유 id입니다.
openingJobPositionIdInteger필수지원자가 선택 가능한 모집분야 값 고유 id입니다.
createdAtString필수공고 모집분야 설정 정보 생성일입니다.
updatedAtString필수공고 모집분야 설정 정보 수정일입니다.