지원자 등록 요청

📘
지원자 등록(지원 접수) 를 요청합니다.

요청 URL

POST https://oapi.greetinghr.com/openapi/applicant

요청 파라미터

Content-Type: application/json

필드	타입	필수 여부	설명	파라미터 타입	비고
openingId	Integer	`필수`	그리팅 공고 id 입니다.	Body
name	String	`필수`	지원자 이름입니다.	Body	- 최대 길이 : 30
email	String	`선택`	지원자 이메일입니다.	Body	- 최대 길이 : 255
phone	String	`선택`	지원자 핸드폰 번호입니다.	Body	- `-` 없이 숫자만 - 최소 길이 : 9 - 최대 길이 : 11
referer	String	`선택`	지원자 지원 경로입니다.	Body	- 최대 길이 : 100
optionalTermsAgree	Boolean	`선택`	개인정보 선택 수집 항목 동의 여부입니다.	Body
documents	Object[]	`선택`	지원 서류 제출 정보입니다.	Body
questionnaires	Object[]	`선택`	사전 질문 제출 정보입니다.	Body
additionalApplicantInfo	Object	`선택`	추가 정보 제출 정보입니다.	Body
needNotify	Boolean	`선택`	지원 알림 이메일 발송 여부입니다.	Body
additionalTermAgrees	Object[]	`선택`	지원자 추가 정보 약관 동의 여부입니다.	Body	추후 삭제 예정
termAgreements	Object	`선택`	동의서에 대한 동의 여부입니다.	Body	공고 상세 정보 조회 V2에서 받은 동의서(termsInfo)에 대한 동의여부

요청 파라미터 (documents)

필드	타입	필수 여부	설명	비고
fileUrl	String	`선택`	제출 서류가 포함된 URL 입니다.	- 반드시 다운로드가 가능한 형태의 Public URL 로 전달 해주세요.
filename	String	`선택`	제출 서류 파일명입니다.	- 확장자 포함
fileToken	String	`선택`	제출 서류 정보가 포함된 토큰입니다.	- fileToken을 이용하여 업로드할 경우 fileUrl과 filename은 null로 전달해 주세요
docName	String	`필수`	그리팅 내 표기될 지원 서류 이름입니다. (이력서, 자기소개서 등)

요청 파라미터 (questionnaires)

필드	타입	필수 여부	설명	비고
question	String	`필수`	사전 질문입니다.
answer	String	`필수`	사전 질문에 대한 답변입니다.	- 최대 길이 : 255

요청 파라미터 (additionalApplicantInfo)

필드	타입	필수 여부	설명	비고
gender	Enum	`선택`	성별입니다. - `MALE`: 남성 - `FEMALE` : 여성 - `NOT_SELECTED` : 선택 안함
birthday	String	`선택`	생년월일입니다.	- yyyy-MM-dd 포멧
careerType	Enum	`선택`	경력 사항입니다. - `NEW_COMER` : 신입 - `EXPERIENCED` : 경력
militaryService	Enum	`선택`	복무 대상 여부입니다. - `TARGET` : 대상 - `NOT_TARGET` : 비대상
militaryStatus	Enum	`선택`	복무 형태입니다. - `FULL_FILLED` : 군필 - `UN_FULL_FILLED` : 미필 - `EXEMPTED` : 면제 - `IN_SERVICE` : 복무중
typeOfDisability	String	`선택`	장애 종류입니다.	- 최대 길이 : 50
isDisability	Enum	`선택`	장애 대상 여부입니다. - `TARGET` : 대상 - `NOT_TARGET` : 비대상
severityOfSymptoms	String	`선택`	장애 중증도입니다.	- 최대 길이 : 255
veteranStatus	Enum	`선택`	보훈 대상 여부입니다. - `TARGET` : 대상 - `NOT_TARGET` : 비대상
veteranCode	String	`선택`	보훈 대상 여부입니다.	- 00-000000 포멧
educationalBackgrounds	Object[]	`선택`	학력사항입니다.
careers	Object[]	`선택`	경력사항입니다.
certificates	Object[]	`선택`	자격증 사항입니다.
languageSkills	Object[]	`선택`	어학 사항입니다.

요청 파라미터 (educationalBackgrounds)

필드	타입	필수 여부	설명	비고
kind	Enum	`필수`	학위 종류입니다. - `ELEMENTARY_SCHOOL_GRADUATE` : 초등학교 - `MIDDLE_SCHOOL_GRADUATE` : 중학교 - `HIGH_SCHOOL_GRADUATE` : 고등학교 - `ASSOCIATE_DEGREE` : 전문대 - `BACHELOR_DEGREE` : 학사 - `MASTERS_DEGREE` : 석사 - `DOCTOR_DEGREE` : 박사
name	String	`선택`	학교명입니다.	- 최대 길이 : 255
startDate	String	`선택`	입학일입니다.	- yyyy-MM-dd 포멧
endDate	String	`선택`	졸업일입니다.	- yyyy-MM-dd 포멧
score	String	`선택`	학점입니다.	- 최대 길이 : 255
majorField	String	`선택`	계열입니다. (예, 상경, 문과 등)	- 최대 길이 : 255
maxScore	String	`선택`	기준학점입니다. (예, 4.3, 4.5 등)	- 최대 길이 : 255
major	String	`선택`	전공입니다.	- 최대 길이 : 255
isQualificationExaminer	Boolean	`필수`	검정고시 해당 여부입니다.
examinationForEntrancePassDate	String	`선택`	졸업시험 통과일입니다.	- yyyy-MM-dd 포멧
attending	Boolean	`필수`	재학 여부입니다.

요청 파라미터 (careers)

필드	타입	필수 여부	설명	비고
tenureStartDate	String	`선택`	입사일입니다.	- yyyy-MM-dd 포멧
tenureEndDate	String	`선택`	퇴사일입니다.	- yyyy-MM-dd 포멧
position	String	`필수`	직급입니다.	- 최대 길이 : 50
job	String	`필수`	담당 업무입니다.	- 최대 길이 : 1000
inService	Boolean	`필수`	재직 여부입니다.
company	String	`필수`	재직 회사명입니다.	- 최대 길이 : 255

요청 파라미터 (languageSkills)

필드	타입	필수 여부	설명	비고
examName	String	`필수`	시험명입니다.	- 최대 길이 : 100
acquisitionDate	String	`필수`	취득일입니다.	- yyyy-MM-dd 포멧
grade	String	`필수`	시험 점수입니다.	- 최대 길이 : 50
language	String	`필수`	시험 언어입니다.	- 최대 길이 : 255

요청 파라미터 (certificates)

필드	타입	필수 여부	설명	비고
credential	String	`필수`	자격증 이름입니다.	- 최대 길이 : 50
issuer	String	`필수`	발행처입니다.	- 최대 길이 : 50
acquisitionDate	String	`필수`	취득일입니다.	- yyyy-MM-dd 포멧

요청 파라미터 (additionalTermAgrees)

필드	타입	필수 여부	설명	비고
id	Integer	`필수`	약관 ID입니다.
agree	Boolean	`필수`	약관 동의 여부입니다.

요청 파라미터 (termAgreements)

필드	타입	필수 여부	설명	비고
personalRequiredTerm	Object	`필수`	개인정보 필수항목 수집 및 이용 동의서에 대한 동의 여부 입니다.
personalOptionalTerm	Object	`필수`	개인정보 선택항목 수집 및 이용 동의서에 대한 동의 여부입니다.
sensitiveTerm	Object	`선택`	민감정보 수집 및 이용 동의서에 대한 동의 여부 입니다.
customTerms	Object[]	`필수`	범용영역 동의서에 대한 동의여부	없으면 빈 리스트

요청 파라미터 (personalRequiredTerm, personalOptionalTerm, customTerms)

필드	타입	필수 여부	설명	비고
id	Number	`필수`	동의서 id	공고 상세 정보 조회 V2에서 받은 동의서의 id
isAgree	Boolean	`필수`	동의서 동의여부

요청 파라미터 (sensitiveTerm)

필드	타입	필수 여부	설명	비고
id	Number	`필수`	동의서 id	공고 상세 정보 조회 V2에서 받은 동의서의 id
isAgree	Boolean	`필수`	동의서 동의여부
items	Object	`필수`	민감정보 동의 항목

요청 파라미터 (items)

필드	타입	필수 여부	설명
disability	Boolean	`필수`	장애사항 수집 여부
veteranStatus	Boolean	`필수`	보훈사항 수집 여부