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

공고 상세 정보 요청

📘

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


요청 URL

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


요청 파라미터

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

예시 응답

{
    "success": true,
    "data": {
        "openingInfo": {
            "openingId": 1,
            "status": "OPEN",
            "title": "가나다라",
            "detail": "<p>test</p>",
            "openDate": "2022-10-29T13:17:22Z",
            "job": null,
            "placeId": null,
            "place": null,
            "detailPlace": null,
            "workFromHome": false,
            "employmentType": "FULL_TIME_WORKER",
            "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
        }
    },
    "message": null,
    "errorCode": null
}

응답 객체 상세

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

응답 객체 상세 (openingInfo)

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

- OPEN : 공고 활성화
- CLOSE : 공고 비활성화
- ARCHIVE : 공고 보관
titleString필수공고 제목입니다.
detailString선택공고 상세 설명입니다. (html 형식)
openDateString선택공고 생성일입니다.
subsidiaryString선택공고 구분 정보입니다.
jobString선택공고 직군 정보입니다.
placeIdString선택근무지 주소의 Google Maps ID 값입니다.
placeString선택근무지 주소명입니다.
detailPlaceString선택근무지 상세 주소입니다.
workFromHomeBoolean선택재택 근무 여부입니다.
employmentTypeEnum선택고용 형태입니다.

- FULL_TIME_WORKER : 정규직
- CONTRACT_WORKER : 계약직
- INTERN_WORKER : 인턴
- FREE_LANCER : 프리랜서
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 : 필수