공고 전체 리스트 조회

📘

Note

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

요청 URL

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

요청 헤더

X-Api-Version: 2.0


요청 파라미터

필드

타입

필수 여부

파라미터 타입

page

Int

필수

Query

pageSize

Int

필수

Query

title

String

선택

Query

occupation

List<String>

선택

Query

field

List<String>

선택

Query

job

List<String>

선택

Query

place

List<String>

선택

Query

employment

List<Enum>

  • FULL_TIME_WORKER: 정규직
  • CONTRACT_WORKER: 계약직
  • INTERN_WORKER: 인턴
  • FREE_LANCER: 프리랜서
  • MILITARY_SERVICE_EXCEPTION: 병역특례

선택

Query

career

List<Enum>

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

선택

Query

activatedAtCareerPage

Boolean

선택

Query

status

Enum

  • 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<Object>필수지원자가 선택 가능한 모집분야 값 리스트입니다.
<br/>
응답 객체 상세 (openingJobPositionSetting)
필드타입필수 여부설명idInteger필수공고 모집분야 설정 정보 고유 id입니다.maxPriorityInteger필수선택 가능한 모집분야의 최대 갯수입니다.openingIdInteger필수공고의 고유 id입니다.createdAtString필수공고 모집분야 설정 정보 생성일입니다.updatedAtString필수공고 모집분야 설정 정보 수정일입니다.
<br/>
응답 객체 상세 (openingJobPositions)
필드타입필수 여부설명idInteger필수지원자가 선택 가능한 모집분야 값 고유 id입니다.openingIdInteger필수공고의 고유 id입니다.jobPositionPlaceObject선택지원자가 선택 가능한 근무지입니다.jobPositionFieldObject선택지원자가 선택 가능한 부입니다.jobPositionOccupationObject선택지원자가 선택 가능한 직군입니다.jobPositionJobObject선택지원자가 선택 가능한 직무입니다.jobPositionCareerObject선택지원자가 선택 가능한 경력 사항 입니다.jobPositionEmploymentObject선택지원자가 선택 가능한 채용 형태 입니다.createdAtString필수지원자가 선택 가능한 모집분야 값 생성일입니다.updatedAtString필수지원자가 선택 가능한 모집분야 값 수정일입니다.
<br/>
응답 객체 상세 (jobPositionField)
필드타입필수 여부설명idInteger필수부문 고유 id입니다.fieldString필수부문입니다.openingIdInteger필수공고의 고유 id입니다.openingJobPositionIdInteger필수지원자가 선택 가능한 모집분야 값 고유 id입니다.createdAtString필수공고 모집분야 설정 정보 생성일입니다.updatedAtString필수공고 모집분야 설정 정보 수정일입니다.
<br/>
응답 객체 상세 (jobPositionOccupation)
필드타입필수 여부설명idInteger필수직 고유 id입니다.occupationString필수직군입니다.openingIdInteger필수공고의 고유 id입니다.openingJobPositionIdInteger필수지원자가 선택 가능한 모집분야 값 고유 id입니다.createdAtString필수공고 모집분야 설정 정보 생성일입니다.updatedAtString필수공고 모집분야 설정 정보 수정일입니다.
<br/>
응답 객체 상세 (jobPositionJob)
필드타입필수 여부설명idInteger필수직 고유 id입니다.jobString필수직무입니다.openingIdInteger필수공고의 고유 id입니다.openingJobPositionIdInteger필수지원자가 선택 가능한 모집분야 값 고유 id입니다.createdAtString필수공고 모집분야 설정 정보 생성일입니다.updatedAtString필수공고 모집분야 설정 정보 수정일입니다.
<br/>
응답 객체 상세 (jobPositionPlace)
필드타입필수 여부설명idInteger필수근무지 고유 id입니다.locationString필수근무 지역입니다.googleMapIdString선택Google Map 제공 id입니다.placeString선택기본 주소입니다.detailPlaceString선택상세 주소입니다.workFromHomeBoolean선택재택 근무 가능 여부입니다.openingIdInteger필수공고의 고유 id입니다.openingJobPositionIdInteger필수지원자가 선택 가능한 모집분야 값 고유 id입니다.createdAtString필수공고 모집분야 설정 정보 생성일입니다.updatedAtString필수공고 모집분야 설정 정보 수정일입니다.
<br/>
응답 객체 상세 (jobPositionCareer)
<Table align={["left","left","left","left"]}>
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        필드
      </th>
      <th style={{ textAlign: "left" }}>
        타입
      </th>
      <th style={{ textAlign: "left" }}>
        필수 여부
      </th>
      <th style={{ textAlign: "left" }}>
        설명
      </th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        id
      </td>
      <td style={{ textAlign: "left" }}>
        Integer
      </td>
      <td style={{ textAlign: "left" }}>
        `필수`
      </td>
      <td style={{ textAlign: "left" }}>
        경력사항 고유 id입니다.
      </td>
    </tr>
    <tr>
      <td style={{ textAlign: "left" }}>
        careerFrom
      </td>
      <td style={{ textAlign: "left" }}>
        Integer
      </td>
      <td style={{ textAlign: "left" }}>
        `선택`
      </td>
      <td style={{ textAlign: "left" }}>
        최소 경력 연수입니다.
      </td>
    </tr>
    <tr>
      <td style={{ textAlign: "left" }}>
        careerTo
      </td>
      <td style={{ textAlign: "left" }}>
        Integer
      </td>
      <td style={{ textAlign: "left" }}>
        `선택`
      </td>
      <td style={{ textAlign: "left" }}>
        최대 경력 연수입니다.
      </td>
    </tr>
    <tr>
      <td style={{ textAlign: "left" }}>
        careerType
      </td>
      <td style={{ textAlign: "left" }}>
        Enum
        <ul>
          <li>`NEW_COMER`: 신입</li>
          <li>`EXPERIENCED`: 경력</li>
          <li>`NOT_MATTER`: 무관</li>
        </ul>
      </td>
      <td style={{ textAlign: "left" }}>
        `선택`
      </td>
      <td style={{ textAlign: "left" }}>
        경력 사항 구분입니다.
      </td>
    </tr>
    <tr>
      <td style={{ textAlign: "left" }}>
        openingId
      </td>
      <td style={{ textAlign: "left" }}>
        Integer
      </td>
      <td style={{ textAlign: "left" }}>
        `필수`
      </td>
      <td style={{ textAlign: "left" }}>
        공고의 고유 id입니다.
      </td>
    </tr>
    <tr>
      <td style={{ textAlign: "left" }}>
        openingJobPositionId
      </td>
      <td style={{ textAlign: "left" }}>
        Integer
      </td>
      <td style={{ textAlign: "left" }}>
        `필수`
      </td>
      <td style={{ textAlign: "left" }}>
        지원자가 선택 가능한 모집분야 값 고유 id입니다.
      </td>
    </tr>
    <tr>
      <td style={{ textAlign: "left" }}>
        createdAt
      </td>
      <td style={{ textAlign: "left" }}>
        String
      </td>
      <td style={{ textAlign: "left" }}>
        `필수`
      </td>
      <td style={{ textAlign: "left" }}>
        공고 모집분야 설정 정보 생성일입니다.
      </td>
    </tr>
    <tr>
      <td style={{ textAlign: "left" }}>
        updatedAt
      </td>
      <td style={{ textAlign: "left" }}>
        String
      </td>
      <td style={{ textAlign: "left" }}>
        `필수`
      </td>
      <td style={{ textAlign: "left" }}>
        공고 모집분야 설정 정보 수정일입니다.
      </td>
    </tr>
  </tbody>
</Table>
<br/>
응답 객체 상세 (jobPositionEmployment)
<Table align={["left","left","left","left"]}>
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        필드
      </th>
      <th style={{ textAlign: "left" }}>
        타입
      </th>
      <th style={{ textAlign: "left" }}>
        필수 여부
      </th>
      <th style={{ textAlign: "left" }}>
        설명
      </th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        id
      </td>
      <td style={{ textAlign: "left" }}>
        Integer
      </td>
      <td style={{ textAlign: "left" }}>
        `필수`
      </td>
      <td style={{ textAlign: "left" }}>
        채용 형태 고유 id입니다.
      </td>
    </tr>
    <tr>
      <td style={{ textAlign: "left" }}>
        employment
      </td>
      <td style={{ textAlign: "left" }}>
        Enum
        <ul>
          <li>`FULL_TIME_WORKER`: 정규직</li>
          <li>`CONTRACT_WORKER`: 계약직</li>
          <li>`INTERN_WORKER`: 인턴</li>
          <li>`FREE_LANCER`: 프리랜서</li>
          <li>`MILITARY_SERVICE_EXCEPTION`: 병역특례</li>
        </ul>
      </td>
      <td style={{ textAlign: "left" }}>
        `필수`
      </td>
      <td style={{ textAlign: "left" }}>
        채용 형태입니다.
      </td>
    </tr>
    <tr>
      <td style={{ textAlign: "left" }}>
        openingId
      </td>
      <td style={{ textAlign: "left" }}>
        Integer
      </td>
      <td style={{ textAlign: "left" }}>
        `필수`
      </td>
      <td style={{ textAlign: "left" }}>
        공고의 고유 id입니다.
      </td>
    </tr>
    <tr>
      <td style={{ textAlign: "left" }}>
        openingJobPositionId
      </td>
      <td style={{ textAlign: "left" }}>
        Integer
      </td>
      <td style={{ textAlign: "left" }}>
        `필수`
      </td>
      <td style={{ textAlign: "left" }}>
        지원자가 선택 가능한 모집분야 값 고유 id입니다.
      </td>
    </tr>
    <tr>
      <td style={{ textAlign: "left" }}>
        createdAt
      </td>
      <td style={{ textAlign: "left" }}>
        String
      </td>
      <td style={{ textAlign: "left" }}>
        `필수`
      </td>
      <td style={{ textAlign: "left" }}>
        공고 모집분야 설정 정보 생성일입니다.
      </td>
    </tr>
    <tr>
      <td style={{ textAlign: "left" }}>
        updatedAt
      </td>
      <td style={{ textAlign: "left" }}>
        String
      </td>
      <td style={{ textAlign: "left" }}>
        `필수`
      </td>
      <td style={{ textAlign: "left" }}>
        공고 모집분야 설정 정보 수정일입니다.
      </td>
    </tr>
  </tbody>
</Table>