공고 상세 정보 요청 v1

📘

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

복수개의 모집분야가 있는 경우 대푯값 1개만 반환합니다. 1개 이상 활용하는 고객분들께서는 해당 API를 활용해 주세요.


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

필드

타입

필수 여부

설명

openingId

Integer

필수

공고 id 입니다.

status

Enum

필수

공고의 상태 정보입니다.

  • OPEN : 공고 활성화
  • CLOSE : 공고 비활성화
  • ARCHIVE : 공고 보관

title

String

필수

공고 제목입니다.

detail

String

선택

공고 상세 설명입니다. (html 형식)

openDate

String

선택

공고 생성일입니다.

subsidiary

String

선택

공고 구분 정보입니다.

job

String

선택

공고 직군 정보입니다.

placeId

String

선택

근무지 주소의 Google Maps ID 값입니다.

place

String

선택

근무지 주소명입니다.

detailPlace

String

선택

근무지 상세 주소입니다.

workFromHome

Boolean

선택

재택 근무 여부입니다.

employmentType

Enum

선택

고용 형태입니다.

  • FULL_TIME_WORKER : 정규직
  • CONTRACT_WORKER : 계약직
  • INTERN_WORKER : 인턴
  • FREE_LANCER : 프리랜서

dueDate

String

선택

공고 마감일입니다.

deploy

Boolean

선택

공고 채용사이트 게시 여부입니다.

응답 객체 상세 (groupInfo)

필드타입필수 여부설명
groupIdInteger필수워크스페이스 id 입니다.
nameString필수워크스페이스 이름입니다.
imageUrlString선택워크스페이스 프로필 URL 입니다.

응답 객체 상세 (documents)

필드타입필수 여부설명
docIdString필수지원서류 id 입니다.
nameString필수지원서류 이름입니다.
detailString선택지원서류 상세 설명입니다.
needBoolean선택지원서류 필수 제출 여부입니다.
formsObject[]선택지원서류 양식 파일 정보입니다.

응답 객체 상세 (forms)

필드타입필수 여부설명
fileNameString필수양식 파일명입니다.
fileTypeString필수양식 파일 확장자명입니다.
fileSizeString필수양식 파일 파일크기입니다.
formUrlString선택양식 파일 다운로드 URL입니다.

응답 객체 상세 (questionnaires)

필드

타입

필수 여부

설명

questionnaireId

String

필수

사전 질문 id 입니다.

question

String

필수

사전 질문입니다.

type

Integer

선택

사전 질문 유형입니다.

  • 100 : 텍스트 입력
  • 200 : 단건 선택
  • 300 : 복수 선택
  • 400 : 지원 경로 입력

need

Boolean

선택

사전 질문 필수 제출 여부입니다.

description

String

선택

사전 질문 상세 설명입니다.

maxLength

Integer

선택

사전 질문 최대 답변 길이입니다.

items

String[]

선택

사전 질문 선택지입니다.

isDirectly

Boolean

필수

사전 질문 직접 등록 가능 여부입니다.

응답 객체 상세 (careerInfo)

필드

타입

필수 여부

설명

from

Integer

선택

최소 경력입니다.
(EXPERIENCED 만 해당)

to

Integer

선택

최대 경력입니다.
(EXPERIENCED 만 해당)

type

Enum

선택

경력 사항 구분입니다.

  • 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)

필드

타입

필수 여부

설명

gender

Enum

선택

성별 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함
  • OPTIONAL : 선택
  • REQUIRED : 필수

birthday

Enum

선택

생년월일 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함
  • OPTIONAL : 선택
  • REQUIRED : 필수

educationalBackground

Enum

선택

학력사항 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함
  • OPTIONAL : 선택
  • REQUIRED : 필수

educationalBackgroundNotice

String

선택

학력사항 제출 유의사항입니다.

career

Enum

선택

경력사항 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함
  • OPTIONAL : 선택
  • REQUIRED : 필수

careerNotice

String

선택

경력사항 제출 유의사항입니다.

languageSkill

Enum

선택

어학사항 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함
  • OPTIONAL : 선택
  • REQUIRED : 필수

languageSkillNotice

String

선택

어학사항 제출 유의사항입니다.

certificate

Enum

선택

자격증 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함
  • OPTIONAL : 선택
  • REQUIRED : 필수

certificateNotice

String

선택

자격증 제출 유의사항입니다.

militaryService

Enum

선택

복무 사항 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함
  • OPTIONAL : 선택
  • REQUIRED : 필수

disability

Enum

선택

장애 사항 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함
  • OPTIONAL : 선택
  • REQUIRED : 필수

veteranStatus

Enum

선택

보훈 사항 제출 여부입니다.

  • NOT_RECEIVED : 제출 안함
  • OPTIONAL : 선택
  • REQUIRED : 필수