활성화된 공고들의 정보를 불러옵니다.
해당 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)
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
id | Integer | 필수 | 공고의 고유 id입니다. |
title | String | 필수 | 공고의 제목입니다. |
job | String | 선택 | 공고의 직군 정보입니다. |
employmentType | String | 선택 | 공고의 고용 형태 정보입니다. |
dueDate | String | 선택 | 공고의 마감일 정보입니다. |
careerInfo | Object | 선택 | 공고의 경력사항 정보입니다. |
place | String | 선택 | 공고의 주소지 정보입니다. |
detailPlace | String | 선택 | 공고의 상세주소지 정보입니다. |
url | String | 필수 | 공고의 링크입니다. |
activatedAtCareerPage | Boolean | 필수 | 공고의 채용 사이트 게시 여부입니다. |
workFromHome | Boolean | 선택 | 공고의 근무지 중 원격근무 여부입니다. |
응답 객체 상세 (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 |