지원
지원자 지원
POST https://api.roundhr.com/v1/application_forms/{code}/apply
지원자가 지원서 페이지를 통해 직접 지원할 시 사용합니다.
요청 예제
curl --request 'POST' \
--url 'https://api.roundhr.com/v1/application_forms/{code}' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer MY_API_KEY'
--data '{
"privacy": true,
"questions": [{"question_id":53, "kind":"name", "answer":{"name":"박라운"}},
{"question_id":54, "kind":"email", "answer":{"email":"[email protected]"}}]
}'헤더
Content-Type
application/json
Authorization
Bearer <token>
요청 파라미터
privacy
boolean
required
개인정보 선택 항목 수집/이용 동의
body
questions
object[]
required
설정한 지원서 질문 목록에 대한 답변
body
요청 파라미터 - questions
지원서 상세 API 요청 후 응답받은 결과의 questions 항목 참고하여 아래 question id 와 kind 데이터 입력 바랍니다.
question_id
integer
required
question id
body
kind
string
required
question kind
body
answer
object
required
질문에 대한 지원자의 답변
body
요청 파라미터 - answer
질문 kind 에 따라 답변 포맷이 달라집니다.
kind: name
name
string
required
지원자 이름
body
kind: email
string
required
지원자 이메일
body
kind: phone
phone
string
required
지원자 연락처
body
kind: resume
resume_path
string
required
지원자 이력서 URL
body
실제 서버 전송시에는 resume_path 를 디코딩 (decodeURIComponent) 하여 전송해 주세요. resume_path 는 전체 주소가 아닌 path 경로만 전송해 주세요.
kind: experience_total
experience_total_period
integer
required
총 경력 (월단위)
body
kind: desired_salary
desired_salary
integer
required
희망연봉
body
kind: current_salary
current_salary
integer
required
현재연봉
body
kind: gender
gender
string
required
성별
male : 남자
female : 여자
body
kind: birth
birth
string
required
생년월일
body
kind: profile_img
profile_img_path
string
required
증명 사진
body
kind: address
address
string
required
주소
body
kind: experience
experiences
object[]
required
경력 리스트
body
요청 파라미터 - experiences
company_name
string
required
회사명
body
start_at
string
optional
입사년월
body
end_at
string
optional
퇴사년월
body
currently_employed
boolean
optional
재직여부
body
employment_type
string
optional
고용형태
body
position
string
optional
직급/직책
body
department
string
optional
근무 부서
body
title
string
optional
직무
body
kind: education
educations
object[]
required
학력 리스트
body
요청 파라미터 - educations
school_name
string
required
학교명
body
enter_at
string
optional
입학년월
body
graduate_at
string
optional
졸업년월
body
graduate
boolean
optional
재학여부
body
major
string
optional
전공
body
kind: qualification
qualifications
object[]
required
자격/수상 리스트
body
요청 파라미터 - qualifications
kind
string
required
구분
자격증: award
수상: certificate
body
name
string
required
자격증명/수상명
body
institution_name
string
required
주최기관/발행처
body
grade
string
required
점수/급
body
date
string
required
취득일
body
content
string
optional
상세내용
body
kind: training
trainings
object[]
required
교육사항 리스트
body
요청 파라미터 - trainings
name
string
required
교육명
body
institution_name
string
required
교육기관
body
start_date
string
required
시작일
body
end_date
string
required
종료일
body
content
string
optional
상세내용
body
kind: language
languages
object[]
required
어학 리스트
body
요청 파라미터 - languages
kind
string
required
언어
body
test_name
string
required
시험명
body
institution_name
string
required
주최기관
body
grade
string
required
점수/급
body
date
string
required
취득일
body
kind: military_service
checked
boolean
required
병역이행 여부
body
military_service_status
string
optional
병역 상태
군필: complete
미필: incomplete
면제: exemption
복무중: in_service
body
kind: veteran_affair
checked
boolean
required
보훈대상 여부
body
veteran_affair_code
string
optional
보훈 번호 - 포맷: 00-000000
body
kind: disability
checked
boolean
required
장애 여부
body
disability_type
string
optional
장애 타입 - 아래 추가
body
disability_severity
string
optional
장애 정도 - mild : 경증 - serious : 중증
body
kind: text, textarea, dropdown, radio, date_type
value
string
required
단답형, 장문형, 드롭다운, 라디오 타입, 날짜형 질문에 대한 답변
body
kind: checkbox
values
string[]
required
체크박스 질문에 대한 답변
body
kind: link
links
string[]
required
링크형 질문에 대한 답변
body
kind: file_upload
links
string[]
required
파일업로드형 질문에 대한 답변
body
응답 예제
지원한 지원자의 기본 정보를 반환합니다.
Last updated
Was this helpful?