### 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: ' ``` -------------------------------- ### 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) - 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 } ``` ```