지원자 등록 요청

📘

Note

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


요청 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

필수

사전 질문에 대한 답변입니다.

  • 최대 길이 : 1000

요청 파라미터 (additionalApplicantInfo)

필드

타입

필수 여부

설명

비고

gender

Enum

선택

성별입니다.

  • MALE: 남성
  • FEMALE: 여성
  • NOT_SELECTED: 선택 안함

birthday

String

선택

생년월일입니다.

  • yyyy-mm-dd 포맷

englishName

String

선택

영문 이름입니다.

  • 최대 길이 : 100

address

String

선택

주소입니다.

  • 최대 길이 : 255

detailAddress

String

선택

상세 주소입니다.

  • 최대 길이 : 255

careerType

Enum

선택

경력 사항입니다.

  • NEW_COMER : 신입
  • EXPERIENCED : 경력

militaryService

Enum

선택

복무 대상 여부입니다.

  • TARGET : 대상
  • NOT_TARGET : 비대상

militaryStatus

Enum

선택

복무 형태입니다.

  • FULL_FILLED : 군필
  • UN_FULL_FILLED : 미필
  • EXEMPTED : 면제
  • IN_SERVICE : 복무 중

militaryKind

Enum

선택

군 복무 유형입니다.

enlistmentDate

String

선택

입대일입니다.

dischargeDate

String

선택

제대일입니다.

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[]

선택

어학 사항입니다.

outsideActivities

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

isQualification
Examiner

Boolean

필수

검정고시 해당 여부입니다.

examination
ForEntrance PassDate

String

선택

졸업시험 통과일입니다.

  • yyyy-MM-dd 포맷

attending

Boolean

필수

재학 여부입니다.

isNightUniversity

Boolean

선택

야간 대학 여부입니다.


요청 파라미터 (careers)

필드

타입

필수 여부

설명

비고

tenureStartDate

String

선택

입사일입니다.

  • yyyy-MM-dd 포멧

tenureEndDate

String

선택

퇴사일입니다.

  • yyyy-MM-dd 포멧

position

String

필수

직급입니다.

  • 최대 길이 : 50

job

String

필수

담당 업무입니다.

  • 최대 길이 : 1000

inService

Boolean

필수

재직 여부입니다.

company

String

필수

재직 회사명입니다.

  • 최대 길이 : 255

type

Enum

선택

경력 유형입니다.


요청 파라미터 (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)

필드타입필수 여부설명비고
idInteger필수약관 ID입니다.
agreeBoolean필수약관 동의 여부입니다.

요청 파라미터 (termAgreements)

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

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

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

요청 파라미터 (sensitiveTerm)

필드타입필수 여부설명비고
idNumber필수동의서 id공고 상세 정보 조회 V2에서 받은 동의서의 id
isAgreeBoolean필수동의서 동의여부
itemsObject필수민감정보 동의 항목

요청 파라미터 (items)

필드타입필수 여부설명비고
disabilityBoolean필수장애사항 수집 여부
veteranStatusBoolean필수보훈사항 수집 여부

요청 파라미터 (outsideActivities)

필드

타입

필수 여부

설명

비고

activityType

Enum

필수

활동 유형입니다.

startDateOfActivity

String

필수

활동 시작일입니다.

  • yyyy-MM-dd 포맷

endDateOfActivity

String

필수

활동 종료일입니다.

  • yyyy-MM-dd 포맷

location

String

필수

활동 장소/기관입니다.

content

String

선택

활동 내용입니다.

  • 최대 길이: 1000