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

📘

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

❗️

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


요청 URL

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


요청 파라미터

  <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>
    job
  </td>

  <td>
    List<String>
  </td>

  <td>
    `선택`
  </td>

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

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

<tr>
  <td>
    careerType
  </td>

  <td>
    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>
필드
page

예시 응답

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

  <th>
    타입
  </th>

  <th>
    필수 여부
  </th>

  <th>
    설명
  </th>
</tr>
  <td>
    Integer
  </td>

  <td>
    `선택`
  </td>

  <td>
    최소 경력입니다.\
    (`EXPERIENCED` 만 해당)
  </td>
</tr>

<tr>
  <td>
    to
  </td>

  <td>
    Integer
  </td>

  <td>
    `선택`
  </td>

  <td>
    최대 경력입니다.\
    (`EXPERIENCED` 만 해당)
  </td>
</tr>

<tr>
  <td>
    type
  </td>

  <td>
    Enum
  </td>

  <td>
    `선택`
  </td>

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

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