Talent Recruitment Management

https://guide.greetinghr.com/ko
Admin
This project provides comprehensive documentation for a talent recruitment and management system,...
Tokens:117,857
Snippets:1,133
Trust Score:9.5
Update:4 months ago
Show doc for...
Tokens:
Raw
### Example Response for Published Openings

Source: https://guide.greetinghr.com/ko/articles/published-openings-a5630fcc

This is an example of the JSON response when requesting published openings. It includes pagination details and a list of job postings with their respective information.

```JSON
{
  "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
}
```

--------------------------------

### Example Response for Passed Applicants

Source: https://guide.greetinghr.com/ko/articles/passed-applicants-4553a5c5

This is an example of the JSON response structure when successfully retrieving a list of passed applicants. It includes pagination details and a list of applicant data.

```JSON
{
  "success": true,
  "data": {
     "page": 0,
     "pageSize": 10,
     "totalCount": 1,
     "totalPage": 0,
     "hasPrev": false,
     "hasNext": false,
     "datas": [{
       "id": 1,
       "name": "이름",
       "email": "test@test.com",
       "phone": "01000000000",
       "submitdate": "2022-01-01T00:00:00.000Z",
       "score": 0,
       "scoreCount": 0,
       "quickNote": null,
       "passDate": "2022-01-01T00:00:00.000Z",
       "referer": "saramin.co.kr",
       "refererName": "사람인",
       "openingId": 100,
       "openingTitle": "공고 이름",
       "desiredJobPositions": [],
     }]
  },
 "message": null,
 "errorCode": null
}
```

--------------------------------

### Example Response for All Job Positions

Source: https://guide.greetinghr.com/ko/articles/all-job-positions-a7e512f2

Illustrates the structure of the response when querying all job positions. The response includes details about occupations, fields, jobs, places, employments, and careers.

```JSON
{
  "success": true,
  "data": [
    {
      "occupations": [],
      "occupationCount": 0,
      "fields": [],
      "fieldCount": 0,
      "jobs": [],
      "jobCount": 0,
      "places": [],
      "placeCount": 0,
      "employments": [],
      "employmentCount": 0,
      "careers": [],
      "careerCount": 0
    }
  ],
  "message": null,
  "errorCode": null
}
```

--------------------------------

### 그리팅 API 요청 예시 (curl)

Source: https://guide.greetinghr.com/ko/articles/crtfd-1d1b706f

REST API 요청 시 `X-Greeting-OpenAPI` 헤더에 발급받은 API Key를 포함하여 모든 API에 접근할 수 있습니다. API Key는 사전 허가를 받은 경우에만 유효합니다.

```bash
curl --request GET \
--url 'https://oapi.greetinghr.com/openapi/all-jobs' \
--header 'X-Greeting-OpenAPI: <apiKey>'
```

--------------------------------

### Get All Job Positions

Source: https://guide.greetinghr.com/ko/articles/all-job-positions-a7e512f2

Retrieves a list of all job positions from GreetingHR. Requires an API version header.

```HTTP
GET https://oapi.greetinghr.com/openapi/all-job-positions
X-Api-Version: 2.0
```

--------------------------------

### GET /openapi/published-openings

Source: https://guide.greetinghr.com/ko/articles/published-openings-a5630fcc

Retrieves a list of active job openings. This API is scheduled for deprecation on July 13, 2025.

```APIDOC
## GET /openapi/published-openings

### Description
Retrieves a list of active job openings. This API is scheduled for deprecation on July 13, 2025.

### Method
GET

### Endpoint
https://oapi.greetinghr.com/openapi/published-openings

### Parameters
#### Query Parameters
- **page** (Int) - Required - Page number. Starts from 0.
- **pageSize** (Int) - Required - Number of data items returned per page. Limited to a maximum of 100.
- **title** (String) - Optional - The title of the opening to search for.
- **job** (List<String>) - Optional - The job category of the opening to search for. Can search multiple categories with OR conditions.
- **careerType** (Enum) - Optional - Career information for the opening to search for. Possible values: NEW_COMER (신입), EXPERIENCED (경력), NOT_MATTER (무관).
- **activatedAtCareerPage** (Boolean) - Optional - Whether the opening is published on the career site. TRUE for published openings, FALSE for unpublished openings.

### Response
#### Success Response (200)
- **success** (Boolean) - Indicates if the request was successful.
- **data** (Object) - Contains the response data.
  - **page** (Integer) - Current page number.
  - **pageSize** (Integer) - Number of items per page.
  - **totalCount** (Integer) - Total number of available openings.
  - **totalPage** (Integer) - Total number of pages.
  - **hasPrev** (Boolean) - Indicates if there is a previous page.
  - **hasNext** (Boolean) - Indicates if there is a next page.
  - **datas** (Array) - List of job openings.
    - **id** (Integer) - Required - Unique ID of the opening.
    - **title** (String) - Required - Title of the opening.
    - **job** (String) - Optional - Job category information.
    - **employmentType** (String) - Optional - Employment type information.
    - **dueDate** (String) - Optional - Due date of the opening.
    - **careerInfo** (Object) - Optional - Career information for the opening.
      - **from** (Integer) - Optional - Minimum years of experience (only for EXPERIENCED).
      - **to** (Integer) - Optional - Maximum years of experience (only for EXPERIENCED).
      - **type** (Enum) - Optional - Career type: NEW_COMER, EXPERIENCED, NOT_MATTER.
    - **place** (String) - Optional - Location information of the opening.
    - **detailPlace** (String) - Optional - Detailed location information.
    - **url** (String) - Required - Link to the opening.
    - **activatedAtCareerPage** (Boolean) - Required - Whether the opening is published on the career site.
    - **workFromHome** (Boolean) - Optional - Whether remote work is possible.
- **message** (null) - Null if successful.
- **errorCode** (null) - Null if successful.

### Request Example
```json
{
  "page": 0,
  "pageSize": 10,
  "title": "",
  "job": [],
  "careerType": "",
  "activatedAtCareerPage": true
}
```

### Response Example
```json
{
  "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
}
```
```

--------------------------------

### 설문 응답 조회

Source: https://guide.greetinghr.com/ko/articles/forms-answer-0e114ca0

특정 지원자의 설문 응답 정보를 조회합니다. 지원자 ID를 경로 변수로 사용하며, 선택적으로 응답 상태를 쿼리 파라미터로 지정할 수 있습니다.

```APIDOC
## GET /openapi/applicants/{applicantId}/forms-answer

### Description
특정 지원자의 설문 응답 정보를 조회합니다. 지원자 ID를 경로 변수로 사용하며, 선택적으로 응답 상태를 쿼리 파라미터로 지정할 수 있습니다.

### Method
GET

### Endpoint
/openapi/applicants/{applicantId}/forms-answer

### Parameters
#### Path Parameters
- **applicantId** (Integer) - 필수 - 지원자 고유 id입니다.

#### Query Parameters
- **status** (Enum) - 선택 - 응답 상태 입니다.

### Response
#### Success Response (200)
- **responses** (Object[]) - 필수 - 해당 지원자의 폼 응답값입니다.
  - **responseId** (Long) - 필수 - 응답 고유 id입니다.
  - **formId** (Long) - 필수 - 응답을 한 설문지의 고유 id입니다.
  - **formTitle** (String) - 필수 - 응답을 한 설문지의 제목입니다.
  - **answers** (Object[]) - 필수 - 응답(질문&답변)의 상세 내용입니다.
    - **questionId** (Long) - 필수 - 질문 고유 id입니다.
    - **questionTitle** (String) - 필수 - 질문 내용입니다.
    - **answers** (Object[]) - 필수 - 질문에 대한 답변입니다.
      - **answerId** (Long) - 필수 - 답변 고유 id입니다.
      - **answerContent** (String) - 필수 - 답변 내용입니다.
      - **answerDownloadUrl** (String) - 선택 - 답변 다운로드 url입니다. (파일 형태의 답변인 경우)

#### Response Example
```json
{
  "success": true,
  "data": {
    "responses": [
      {
        "responseId": 1,
        "formId": 1,
        "formTitle": "설문",
        "answers": [
          {
            "questionId": 1,
            "questionTitle": "이름을 입력하세요",
            "answers": [
              {
                "answerId": 1,
                "answerContent": "홍길동",
                "answerDownloadUrl": null
              }
            ]
          },
          {
            "questionId": 2,
            "questionTitle": "주소를 입력하세요",
            "answers": [
              {
                "answerId": 2,
                "answerContent": "서울특별시",
                "answerDownloadUrl": null
              }
            ]
          }
        ]
      }
    ]
  },
  "message": null,
  "errorCode": null
}
```
```
Tokens:
Raw