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>
|
| Query |
career | List<Enum>
|
| Query |
activatedAtCareerPage | Boolean |
| Query |
status | Enum
|
| 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>