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

📘

Note

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

❗️

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


요청 URL

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


요청 파라미터

필드

타입

필수 여부

설명

파라미터 타입

page

Int

필수

페이지 번호입니다. 0부터 시작합니다.

Query

pageSize

Int

필수

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

Query

title

String

선택

검색하고자 하는 공고의 제목입니다.

Query

job

List<String>

선택

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

Query

careerType

Enum

선택

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

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

Query

activatedAtCareerPage

Boolean

선택

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

  • 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
}
<br/>
응답 객체 상세 (datas)
필드타입필수 여부설명idInteger필수공고의 고유 id입니다.titleString필수공고의 제목입니다.jobString선택공고의 직군 정보입니다.employmentTypeString선택공고의 고용 형태 정보입니다.dueDateString선택공고의 마감일 정보입니다.careerInfoObject선택공고의 경력사항 정보입니다.placeString선택공고의 주소지 정보입니다.detailPlaceString선택공고의 상세주소지 정보입니다.urlString필수공고의 링크입니다.activatedAtCareerPageBoolean필수공고의 채용 사이트 게시 여부입니다.workFromHomeBoolean선택공고의 근무지 중 원격근무 여부입니다.
<br/>
응답 객체 상세 (careerInfo)
<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" }}>
        from
      </td>
      <td style={{ textAlign: "left" }}>
        Integer
      </td>
      <td style={{ textAlign: "left" }}>
        `선택`
      </td>
      <td style={{ textAlign: "left" }}>
        최소 경력입니다.<br/>
        (`EXPERIENCED` 만 해당)
      </td>
    </tr>
    <tr>
      <td style={{ textAlign: "left" }}>
        to
      </td>
      <td style={{ textAlign: "left" }}>
        Integer
      </td>
      <td style={{ textAlign: "left" }}>
        `선택`
      </td>
      <td style={{ textAlign: "left" }}>
        최대 경력입니다.<br/>
        (`EXPERIENCED` 만 해당)
      </td>
    </tr>
    <tr>
      <td style={{ textAlign: "left" }}>
        type
      </td>
      <td style={{ textAlign: "left" }}>
        Enum
      </td>
      <td style={{ textAlign: "left" }}>
        `선택`
      </td>
      <td style={{ textAlign: "left" }}>
        경력 사항 구분입니다.
        <ul>
          <li>`NEW_COMER`: 신입</li>
          <li>`EXPERIENCED`: 경력</li>
          <li>`NOT_MATTER`: 무관</li>
        </ul>
      </td>
    </tr>
  </tbody>
</Table>