그리팅 ATS 가이드
API 문서
문의하기그리팅 TRM 가이드그리팅 홈페이지

공고 상세 정보 조회 v2

📘

공고의 상세 정보를 불러옵니다.

복수 개의 모집 분야를 모두 반환합니다.

요청 URL

GET https://oapi.greetinghr.com/openapi/openings/{openingId}


요청 헤더

X-Api-Version: 2.0


요청 파라미터

필드타입필수 여부설명파라미터 타입
openingIdInteger필수공고의 고유 번호(id) 입니다.Path


예시 응답

{
    "success": true,
    "data": {
        "openingInfo": {
            "openingId": 1,
            "status": "OPEN",
            "title": "가나다라",
            "detail": "<p>test</p>",
            "openDate": "2022-10-29T13:17:22Z",
            "dueDate": null,
            "deploy": false
        },
        "groupInfo": {
            "groupId": 1,
            "name": "그리팅",
            "imageUrl": null
        },
        "docsInfo": [
            {
                "docId": "638833c95760ef6ca293e65c",
                "name": "이력서",
                "detail": "PDF 형식으로 올려주세요.",
                "need": true,
                "forms": [
                    {
                        "fileName": "fileName",
                        "fileType": "pdf",
                        "fileSize": 9742296,
                        "formUrl": "https://example.pdf"
                    }
                ]
            },
            {
                "docId": "638833c95760ef6ca293e65d",
                "name": "자기소개서",
                "detail": "PDF 형식으로 올려주세요.",
                "need": true,
                "forms": []
            }
        ],
        "questionnairesInfo": [
          {
                "questionnaireId": "6389acd55760ef6ca293e7e5",
                "question": "사전질문",
                "type": "TEXT",
                "need": true,
                "description": "필수로 답변해주세요",
                "maxLength": 1,
                "items": [],
                "isDirectly": true
            },
            {
                "questionnaireId": "6389acd55760ef6ca293e7e6",
                "question": "다중선택 사전질문",
                "type": "MULTI_SELECT",
                "need": false,
                "description": null,
                "maxLength": 255,
                "items": [
                    "항목 1",
                    "항목 2"
                ],
                "isDirectly": true
            }
        ],
        "careerInfo": {
            "from": 3,
            "to": null,
            "type": "EXPERIENCED"
        },
        "terms": {
            "privacyTerms": null,
            "privacyTermsOptional": null,
            "privacyConsignmentTerms": null,
            "sensitiveInformationTerms": null,
            "additionalTerms": [
              	{
                  "id": 0,
                  "title": "약관 제목",
                  "titleEng": "약관 제목(eng)",
                  "content": "약관 내용",
                  "contentEng": "약관 내용(eng)",
                  "require": true,
                  "order": 0
                }
            ]
        },
        "additionalApplicantInfoConfig": {
            "gender": "OPTIONAL",
            "birthday": "OPTIONAL",
            "educationalBackground": "OPTIONAL",
            "career": "OPTIONAL",
            "languageSkill": "OPTIONAL",
            "certificate": "OPTIONAL",
            "militaryService": "OPTIONAL",
            "disability": "OPTIONAL",
            "veteranStatus": "OPTIONAL",
            "careerNotice": null,
            "educationalBackgroundNotice": null,
            "languageSkillNotice": null,
            "certificateNotice": null
        },
      "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
}

응답 객체 상세

필드타입필수 여부설명
openingInfoObject필수그리팅 내 설정된 공고의 정보입니다.
groupinfoObject필수그리팅 내 워크스페이스 정보입니다.
docsInfoObject[]선택그리팅 내 설정된 지원서류 정보입니다.
questionnairesInfoObject[]선택그리팅 내 설정된 사전질문 정보입니다.
careerInfoObject필수그리팅 내 설정된 공고의 경력 사항 정보입니다.
termsObject필수그리팅 내 설정된 약관 정보입니다.
additionalApplicantInfoConfigObject필수그리팅 내 설정된 추가정보 설정 정보입니다.
openingJobPositionInfoObject선택공고 모집분야 정보입니다.

응답 객체 상세 (openingInfo)

필드타입필수 여부설명
openingIdInteger필수공고 id 입니다.
statusEnum필수공고의 상태 정보입니다.

- OPEN : 공고 활성화
- CLOSE : 공고 비활성화
- ARCHIVE : 공고 보관
titleString필수공고 제목입니다.
detailString선택공고 상세 설명입니다. (html 형식)
openDateString선택공고 생성일입니다.
dueDateString선택공고 마감일입니다.
deployBoolean선택공고 채용사이트 게시 여부입니다.

응답 객체 상세 (groupInfo)

필드타입필수 여부설명
groupIdInteger필수워크스페이스 id 입니다.
nameString필수워크스페이스 이름입니다.
imageUrlString선택워크스페이스 프로필 URL 입니다.

응답 객체 상세 (documents)

필드타입필수 여부설명
docIdString필수지원서류 id 입니다.
nameString필수지원서류 이름입니다.
detailString선택지원서류 상세 설명입니다.
needBoolean선택지원서류 필수 제출 여부입니다.
formsObject[]선택지원서류 양식 파일 정보입니다.

응답 객체 상세 (forms)

필드타입필수 여부설명
fileNameString필수양식 파일명입니다.
fileTypeString필수양식 파일 확장자명입니다.
fileSizeString필수양식 파일 파일크기입니다.
formUrlString선택양식 파일 다운로드 URL입니다.

응답 객체 상세 (questionnaires)

필드타입필수 여부설명
questionnaireIdString필수사전 질문 id 입니다.
questionString필수사전 질문입니다.
typeEnum선택사전 질문 유형입니다.

- TEXT : 텍스트 입력
- SINGLE_SELECT : 단건 선택
- MULTI_SELECT : 복수 선택
- REFERER : 지원 경로 입력
needBoolean선택사전 질문 필수 제출 여부입니다.
descriptionString선택사전 질문 상세 설명입니다.
maxLengthInteger선택사전 질문 최대 답변 길이입니다.
itemsString[]선택사전 질문 선택지입니다.
isDirectlyBoolean필수사전 질문 직접 등록 가능 여부입니다.

응답 객체 상세 (careerInfo)

필드타입필수 여부설명
fromInteger선택최소 경력입니다.
(EXPERIENCED 만 해당)
toInteger선택최대 경력입니다.
(EXPERIENCED 만 해당)
typeEnum선택경력 사항 구분입니다.

- NEW_COMER : 신입
- EXPERIENCED : 경력
- NOT_MATTER : 무관

응답 객체 상세 (terms)

필드타입필수 여부설명
privacyTermsString선택개인정보 필수 항목 수집 및 이용 동의 전문입니다. (html 형식)
privacyTermsOptionalString선택개인정보 선택 항목 수집 및 이용 동의 전문입니다. (html 형식)
privacyConsignmentTermsString선택개인정보 처리 위탁에 대한 고지 전문입니다. (html 형식)
sensitiveInformationTermsString선택민감정보 수집 및 이용 동의 전문입니다. (html 형식)
additionalTermsObject[]선택지원자 추가 약관 정보입니다.

지원자 추가 약관 정보 상세(additionalTerms)

필드타입필수 여부설명
idInteger필수지원자 추가 약관 정보 동의 ID입니다.
titleString필수지원자 추가 약관 정보 동의 제목입니다.
titleEngString선택지원자 추가 약관 정보 동의 제목입니다. (영문)
contentString필수지원자 추가 약관 정보 동의 전문입니다. (html 형식)
contentEngString선택지원자 추가 약관 정보 동의 전문입니다. (영문)(html 형식)
requireBoolean필수지원자 추가 약관 정보 동의 필수 여부입니다.
orderInteger필수지원자 추가 약관 정보 노출 순서입니다.

응답 객체 상세 (additionalApplicantInfoConfig)

필드타입필수 여부설명
genderEnum선택성별 제출 여부입니다.

- NOT_RECEIVED : 제출 안함
- OPTIONAL : 선택
- REQUIRED : 필수
birthdayEnum선택생년월일 제출 여부입니다.

- NOT_RECEIVED : 제출 안함
- OPTIONAL : 선택
- REQUIRED : 필수
educationalBackgroundEnum선택학력사항 제출 여부입니다.

- NOT_RECEIVED : 제출 안함
- OPTIONAL : 선택
- REQUIRED : 필수
educationalBackgroundNoticeString선택학력사항 제출 유의사항입니다.
careerEnum선택경력사항 제출 여부입니다.

- NOT_RECEIVED : 제출 안함
- OPTIONAL : 선택
- REQUIRED : 필수
careerNoticeString선택경력사항 제출 유의사항입니다.
languageSkillEnum선택어학사항 제출 여부입니다.

- NOT_RECEIVED : 제출 안함
- OPTIONAL : 선택
- REQUIRED : 필수
languageSkillNoticeString선택어학사항 제출 유의사항입니다.
certificateEnum선택자격증 제출 여부입니다.

- NOT_RECEIVED : 제출 안함
- OPTIONAL : 선택
- REQUIRED : 필수
certificateNoticeString선택자격증 제출 유의사항입니다.
militaryServiceEnum선택복무 사항 제출 여부입니다.

- NOT_RECEIVED : 제출 안함
- OPTIONAL : 선택
- REQUIRED : 필수
disabilityEnum선택장애 사항 제출 여부입니다.

- NOT_RECEIVED : 제출 안함
- OPTIONAL : 선택
- REQUIRED : 필수
veteranStatusEnum선택보훈 사항 제출 여부입니다.

- NOT_RECEIVED : 제출 안함
- OPTIONAL : 선택
- REQUIRED : 필수

응답 객체 상세 (openingJobPositionInfo)

필드타입필수 여부설명
openingJobPositionSettingObject필수공고 모집분야 설정 정보입니다.
openingJobPositionsList필수지원자가 선택 가능한 모집분야 값 리스트입니다.

응답 객체 상세 (openingJobPositionSetting)

필드타입필수 여부설명
idInteger필수공고 모집분야 설정 정보 고유 id입니다.
maxPriorityInteger필수선택 가능한 모집분야의 최대 갯수입니다.
openingIdInteger필수공고의 고유 id입니다.
createdAtString필수공고 모집분야 설정 정보 생성일입니다.
updatedAtString필수공고 모집분야 설정 정보 수정일입니다.

응답 객체 상세 (openingJobPositions)

필드타입필수 여부설명
idInteger필수지원자가 선택 가능한 모집분야 값 고유 id입니다.
openingIdInteger필수공고의 고유 id입니다.
jobPositionPlaceObject선택지원자가 선택 가능한 근무지입니다.
jobPositionFieldObject선택지원자가 선택 가능한 부입니다.
jobPositionOccupationObject선택지원자가 선택 가능한 직군입니다.
jobPositionJobObject선택지원자가 선택 가능한 직무입니다.
jobPositionCareerObject선택지원자가 선택 가능한 경력 사항 입니다.
jobPositionEmploymentObject선택지원자가 선택 가능한 채용 형태 입니다.
createdAtString필수지원자가 선택 가능한 모집분야 값 생성일입니다.
updatedAtString필수지원자가 선택 가능한 모집분야 값 수정일입니다.

응답 객체 상세 (jobPositionField)

필드타입필수 여부설명
idInteger필수부문 고유 id입니다.
fieldString필수부문입니다.
openingIdInteger필수공고의 고유 id입니다.
openingJobPositionIdInteger필수지원자가 선택 가능한 모집분야 값 고유 id입니다.
createdAtString필수공고 모집분야 설정 정보 생성일입니다.
updatedAtString필수공고 모집분야 설정 정보 수정일입니다.

응답 객체 상세 (jobPositionOccupation)

필드타입필수 여부설명
idInteger필수직 고유 id입니다.
occupationString필수직군입니다.
openingIdInteger필수공고의 고유 id입니다.
openingJobPositionIdInteger필수지원자가 선택 가능한 모집분야 값 고유 id입니다.
createdAtString필수공고 모집분야 설정 정보 생성일입니다.
updatedAtString필수공고 모집분야 설정 정보 수정일입니다.

응답 객체 상세 (jobPositionJob)

필드타입필수 여부설명
idInteger필수직 고유 id입니다.
jobString필수직무입니다.
openingIdInteger필수공고의 고유 id입니다.
openingJobPositionIdInteger필수지원자가 선택 가능한 모집분야 값 고유 id입니다.
createdAtString필수공고 모집분야 설정 정보 생성일입니다.
updatedAtString필수공고 모집분야 설정 정보 수정일입니다.

응답 객체 상세 (jobPositionPlace)

필드타입필수 여부설명
idInteger필수근무지 고유 id입니다.
locationString필수근무 지역입니다.
googleMapIdString선택Google Map 제공 id입니다.
placeString선택기본 주소입니다.
detailPlaceString선택상세 주소입니다.
workFromHomeBoolean선택재택 근무 가능 여부입니다.
openingIdInteger필수공고의 고유 id입니다.
openingJobPositionIdInteger필수지원자가 선택 가능한 모집분야 값 고유 id입니다.
createdAtString필수공고 모집분야 설정 정보 생성일입니다.
updatedAtString필수공고 모집분야 설정 정보 수정일입니다.

응답 객체 상세 (jobPositionCareer)

필드타입필수 여부설명
idInteger필수경력사항 고유 id입니다.
careerFromInteger선택최소 경력 연수입니다.
careerToInteger선택최대 경력 연수입니다.
careerTypeEnum

- NEW_COMER: 신입
- EXPERIENCED : 경
력
- NOT_MATTER : 무관		선택경력 사항 구분입니다.
openingIdInteger필수공고의 고유 id입니다.
openingJobPositionIdInteger필수지원자가 선택 가능한 모집분야 값 고유 id입니다.
createdAtString필수공고 모집분야 설정 정보 생성일입니다.
updatedAtString필수공고 모집분야 설정 정보 수정일입니다.

응답 객체 상세 (jobPositionEmployment)

필드타입필수 여부설명
idInteger필수채용 형태 고유 id입니다.
employmentEnum

- FULL_TIME_WORKER: 정규
- CONTRACT_WORKER : 계약
직
- INTERN_WORKER : 인
턴
- FREE_LANCER : 프리랜
서
- MILITARY_SERVICE_EXCEPTION : 병역특례		필수채용 형태입니다.
openingIdInteger필수공고의 고유 id입니다.
openingJobPositionIdInteger필수지원자가 선택 가능한 모집분야 값 고유 id입니다.
createdAtString필수공고 모집분야 설정 정보 생성일입니다.
updatedAtString필수공고 모집분야 설정 정보 수정일입니다.