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

(사용 중단 예정) 전체 공고 정보 요청

📘

활성화된 공고들의 정보를 불러옵니다.

❗️

해당 API는 2025년 7월 13일 (일요일) 에 사용이 중단됩니다.


요청 URL

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


요청 파라미터

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

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

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

예시 응답

{
  "success": true,
  "data": {
     "page": 0,
     "pageSize": 10,
     "totalCount": 1,
     "totalPage": 0,
     "hasPrev": false,
     "hasNext": false,
     "datas": [{
       "id": 1,
       "title": "채용 공고",
       "job": "개발",
       "employmentType": "프리랜서",
       "workFromHome": true,
       "dueDate": "2022-01-01T00:00:00.000Z",
       "careerInfo": {
         "from": 1,
         "to": 5,
         "type": "EXPERIENCED",
        },
       "place": "대한민국 서울특별시 강남구 강남대로 476",
       "detailPlace": "13층, 어반하이브",
       "url": "career.doodlin.co.kr/o/1",
       "activatedAtCareerPage": true
     }]
  },
 "message": null,
 "errorCode": null
}

응답 객체 상세 (datas)

필드타입필수 여부설명
idInteger필수공고의 고유 id입니다.
titleString필수공고의 제목입니다.
jobString선택공고의 직군 정보입니다.
employmentTypeString선택공고의 고용 형태 정보입니다.
dueDateString선택공고의 마감일 정보입니다.
careerInfoObject선택공고의 경력사항 정보입니다.
placeString선택공고의 주소지 정보입니다.
detailPlaceString선택공고의 상세주소지 정보입니다.
urlString필수공고의 링크입니다.
activatedAtCareerPageBoolean필수공고의 채용 사이트 게시 여부입니다.
workFromHomeBoolean선택공고의 근무지 중 원격근무 여부입니다.

응답 객체 상세 (careerInfo)

필드타입필수 여부설명
fromInteger선택최소 경력입니다.
(EXPERIENCED 만 해당)
toInteger선택최대 경력입니다.
(EXPERIENCED 만 해당)
typeEnum선택경력 사항 구분입니다.

- NEW_COMER : 신입
- EXPERIENCED : 경력
- NOT_MATTER : 무관