지원

지원자 지원

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 '{
          "name": "김라운",
          "email": "[email protected]",
          "resume_path": "/upload/candidate/file/2/temp/resume.pdf"
        }'

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	필수	Description	parameter type
name	string	required	지원자 이름	body
email	string	required	지원자 이메일	body
phone	string	required	지원자 연락처	body
resume_path	string	required	지원자 이력서 URL	body
privacy	boolean	optional	개인정보 선택 항목 수집/이용 동의	body
questions	object[]	optional	설정한 지원서 질문 목록에 대한 답변	body

resume_path 의 경우 upload api 를 통해 파일 업로드 후 업로드한 file_url 의 path 부분을 입력해 주시면 됩니다.

Body - questions

지원서 상세 API 요청 후 응답받은 결과의 questions 항목 참고하여 아래 question id 와 kind 데이터 입력 바랍니다.

Name	Type	필수	Description	parameter type
id	int	required	question id	body
kind	string	required	question kind	body
answer	object	required	질문에 대한 지원자의 답변	body

예제

questions: [
   {
      "id": 1,
      "kind": "gender",
      "answer": { "gender": "male" }
   }
]

Body - answers

질문 kind 에 따라 답변 포맷이 달라집니다.

• kind: gender

Name	Type	필수	Description	parameter type
gender	string	required	성별	body

// 예제
"answer": { "gender": "male" }

• kind: birth

Name	Type	필수	Description	parameter type
birth	string	required	생년월일	body

// 예제
"answer": { "birth": "2000-10-10" }

• kind: military_service

Name	Type	필수	Description	parameter type
checked	boolean	required	병역이행 여부	body
military_service_status	string	optional	군필: complete 미필: incomplete 면제: exemption 복무중: in_service	body

// 예제
"answer": { "checked": true, "military_service_status": "complete" }

// 대상 아닐 경우
"answer": { "checked": false }

• kind: veteran_affair

Name	Type	필수	Description	parameter type
checked	boolean	required	보훈대상 여부	body
veteran_affair_code	string	optional	보훈 번호 - 포맷: 00-000000	body

// 예제
"answer": { "checked": true, "veteran_affair_code": "10-101010" }

• kind: disability

Name	Type	필수	Description	parameter type
checked	boolean	required	장애 여부	body
disability_type	string	optional	장애 타입	body
disability_severity	string	optional	장애 정도: 경증, 중증 - 경증: mild - 중증: serious	body

// 예제
"answer": { 
    "checked": true,
    "disability_type": "physical_disability",
    "disability_severity": "mild"
}

• kind: text, textarea, dropdown, radio, date_type

Name	Type	필수	Description	parameter type
value	string	required	단답형, 장문형, 드롭다운, 라디오 타입, 날짜형 질문에 대한 답변	body

// 예제
"answer": { "value": "단답형 질문 답변" }

• kind: checkbox

Name	Type	필수	Description	parameter type
values	string[]	required	체크박스 질문에 대한 답변	body

// 예제
"answer": { "values": ["option1", "option2"] }

• kind: link

Name	Type	필수	Description	parameter type
links	string[]	required	링크형 질문에 대한 답변	body

// 예제
"answer": { "links": ["https://website1.com", "https://website2.com"] }

• kind: file_upload

Name	Type	필수	Description	parameter type
links	string[]	required	파일업로드형 질문에 대한 답변	body

// 예제
"answer": { "links": ["/upload/candidate/file/1/temp/file1.pdf", "/upload/candidate/file/1/temp/file2.pdf"] }

파일업로드의 links 답변의 경우 upload api 를 통해 파일 업로드 후 업로드한 file_url 의 path 부분을 입력해 주시면 됩니다.

파일 업로드 API 바로가기

응답 예제

지원한 지원자의 기본 정보를 반환합니다.

200

{
   "resource":{
      "code": "w3NfSD7FsY",
      "name": "김라운",
      "email": "[email protected]",
      "phone": "010-1234-1234",
      "duplicate": false,
      "birth": null,
      "privacy": false,
      "resume_path": "/resume.pdf",
      "applied_at": "2024-06-01T00:00:00+09:00",
      "created_at": "2024-06-01T00:00:00+09:00",
      "updated_at": "2024-06-01T00:00:00+09:00"
   }
}