그리팅 ATS 가이드
API 문서
문의하기그리팅 TRM 가이드그리팅 홈페이지
Start typing to search…

공고 전체 리스트 조회

📘

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

요청 URL

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


요청 헤더

X-Api-Version: 2.0


요청 파라미터

  <th>
    타입
  </th>

  <th>
    필수 여부
  </th>

  <th>
    설명
  </th>

  <th>
    파라미터 타입
  </th>
</tr>

  <td>
    Int
  </td>

  <td>
    `필수`
  </td>

  <td>
    페이지 번호입니다. 0부터 시작합니다.
  </td>

  <td>
    Query
  </td>
</tr>

<tr>
  <td>
    pageSize
  </td>

  <td>
    Int
  </td>

  <td>
    `필수`
  </td>

  <td>
    페이지 당 반환되는 데이터의 갯수입니다. 최대 100개로 제한됩니다.
  </td>

  <td>
    Query
  </td>
</tr>

<tr>
  <td>
    title
  </td>

  <td>
    String
  </td>

  <td>
    `선택`
  </td>

  <td>
    검색하고자 하는 공고의 제목입니다.
  </td>

  <td>
    Query
  </td>
</tr>

<tr>
  <td>
    occupation
  </td>

  <td>
    List<String>
  </td>

  <td>
    `선택`
  </td>

  <td>
    검색하고자 하는 공고의 직군입니다. 여러개를 or 조건으로 검색할 수 있습니다.
  </td>

  <td>
    Query
  </td>
</tr>

<tr>
  <td>
    field
  </td>

  <td>
    List<String>
  </td>

  <td>
    `선택`
  </td>

  <td>
    검색하고자 하는 공고의 부문입니다. 여러개를 or 조건으로 검색할 수 있습니다.
  </td>

  <td>
    Query
  </td>
</tr>

<tr>
  <td>
    job
  </td>

  <td>
    List<String>
  </td>

  <td>
    `선택`
  </td>

  <td>
    검색하고자 하는 공고의 직무입니다. 여러개를 or 조건으로 검색할 수 있습니다.
  </td>

  <td>
    Query
  </td>
</tr>

<tr>
  <td>
    place
  </td>

  <td>
    List<String>직
  </td>

  <td>
    `선택`
  </td>

  <td>
    검색하고자 하는 공고의 직무입니다. 여러개를 or 조건으로 검색할 수 있습니다.
  </td>

  <td>
    Query
  </td>
</tr>

<tr>
  <td>
    employment
  </td>

  <td>
    List<Enum>  

    * `FULL_TIME_WORKER`:정규\
      직
    * `CONTRACT_WORKER`: 계약\
      직
    * `INTERN_WORKER` : 인\
      턴
    * `FREE_LANCER` : 프리랜\
      서
    * `MILITARY_SERVICE_EXCEPTION` : 병역특례
  </td>

  <td>
    `선택`
  </td>

  <td>
    검색하고자 하는 공고의 채용 형태입니다. 여러개를 or 조건으로 검색할 수 있습니다.
  </td>

  <td>
    Query
  </td>
</tr>

<tr>
  <td>
    career
  </td>

  <td>
    List<Enum>  

    * `NEW_COMER` : 신입
    * `EXPERIENCED` : 경력
    * `NOT_MATTER` : 무관
  </td>

  <td>
    `선택`
  </td>

  <td>
    검색하고자 하는 공고의 경력사항 정보입니다.
  </td>

  <td>
    Query
  </td>
</tr>

<tr>
  <td>
    activatedAtCareerPage
  </td>

  <td>
    Boolean
  </td>

  <td>
    `선택`
  </td>

  <td>
    검색하고자 하는 공고의 채용 사이트 게시 여부입니다.  

    * `true` 로 전달 시 채용 사이트에 게시된 공고만 불러옵니다.
    * `false` 로 전달 시 채용 사이트에 게시되지 않은 공고만 불러옵니다.
  </td>

  <td>
    Query
  </td>
</tr>

<tr>
  <td>
    status
  </td>

  <td>
    Enum  

    * `OPEN`: 활성\
      화
    * `CLOSE` : 비활성\
      화
    * `ARCHIVE` : 보관함
  </td>

  <td>
    `선택`
  </td>

  <td>
    검색하고자 하는 공고의 상태입니다.
  </td>

  <td>
    Query
  </td>
</tr>
필드
page

예시 응답

{
  "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)

  <th>
    타입
  </th>

  <th>
    필수 여부
  </th>

  <th>
    설명
  </th>
</tr>

  <td>
    Integer
  </td>

  <td>
    `필수`
  </td>

  <td>
    경력사항 고유 id입니다.
  </td>
</tr>

<tr>
  <td>
    careerFrom
  </td>

  <td>
    Integer
  </td>

  <td>
    `선택`
  </td>

  <td>
    최소 경력 연수입니다.
  </td>
</tr>

<tr>
  <td>
    careerTo
  </td>

  <td>
    Integer
  </td>

  <td>
    `선택`
  </td>

  <td>
    최대 경력 연수입니다.
  </td>
</tr>

<tr>
  <td>
    careerType
  </td>

  <td>
    Enum  

    * `NEW_COMER`: 신입
    * `EXPERIENCED` : 경\
      력
    * `NOT_MATTER` : 무관
  </td>

  <td>
    `선택`
  </td>

  <td>
    경력 사항 구분입니다.
  </td>
</tr>

<tr>
  <td>
    openingId
  </td>

  <td>
    Integer
  </td>

  <td>
    `필수`
  </td>

  <td>
    공고의 고유 id입니다.
  </td>
</tr>

<tr>
  <td>
    openingJobPositionId
  </td>

  <td>
    Integer
  </td>

  <td>
    `필수`
  </td>

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

<tr>
  <td>
    createdAt
  </td>

  <td>
    String
  </td>

  <td>
    `필수`
  </td>

  <td>
    공고 모집분야 설정 정보 생성일입니다.
  </td>
</tr>

<tr>
  <td>
    updatedAt
  </td>

  <td>
    String
  </td>

  <td>
    `필수`
  </td>

  <td>
    공고 모집분야 설정 정보 수정일입니다.
  </td>
</tr>
필드
id

응답 객체 상세 (jobPositionEmployment)

  <th>
    타입
  </th>

  <th>
    필수 여부
  </th>

  <th>
    설명
  </th>
</tr>

  <td>
    Integer
  </td>

  <td>
    `필수`
  </td>

  <td>
    채용 형태 고유 id입니다.
  </td>
</tr>

<tr>
  <td>
    employment
  </td>

  <td>
    Enum  

    * `FULL_TIME_WORKER`: 정규
    * `CONTRACT_WORKER` : 계약\
      직
    * `INTERN_WORKER` : 인\
      턴
    * `FREE_LANCER` : 프리랜\
      서
    * `MILITARY_SERVICE_EXCEPTION` : 병역특례
  </td>

  <td>
    `필수`
  </td>

  <td>
    채용 형태입니다.
  </td>
</tr>

<tr>
  <td>
    openingId
  </td>

  <td>
    Integer
  </td>

  <td>
    `필수`
  </td>

  <td>
    공고의 고유 id입니다.
  </td>
</tr>

<tr>
  <td>
    openingJobPositionId
  </td>

  <td>
    Integer
  </td>

  <td>
    `필수`
  </td>

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

<tr>
  <td>
    createdAt
  </td>

  <td>
    String
  </td>

  <td>
    `필수`
  </td>

  <td>
    공고 모집분야 설정 정보 생성일입니다.
  </td>
</tr>

<tr>
  <td>
    updatedAt
  </td>

  <td>
    String
  </td>

  <td>
    `필수`
  </td>

  <td>
    공고 모집분야 설정 정보 수정일입니다.
  </td>
</tr>
필드
id