Loading...

개발자 가이드

  • OpenAPI
  • 개발자 가이드

개발자 가이드

목록 요청
개발자 가이드 목록 : 요청 부분과 다중검색 부분을 포함한 표입니다.
요청 URL https://job.ratis.or.kr/openapi/rcrtList.api
항목 필수여부 설명
authKey 인증키 Y
pageNo 페이지 번호 기본값 1
pageSize 페이지당 건 수 기본값 100, 최대 1000까지 가능
sortOrder 마감일 기준 정렬 방식 기본값 ASC (마감일 순)
- ASC : 순정렬
- DESC : 역순정렬
jobBgCd 직무 대분류 코드 다중 검색 가능 (쉼표로 구분)
jobMdCd 직무 소분류 코드 다중 검색 가능 (쉼표로 구분, 소분류 검색 시 대분류는 검색하지 않음)
emplTypeCd 고용 형태 코드 다중 검색 가능 (쉼표로 구분)
educCd 학력 코드 다중 검색 가능 (쉼표로 구분)
workSdCd 근무 지역(시도) 코드 다중 검색 가능 (쉼표로 구분)
workSggCd 근무 지역(시군구) 코드 다중 검색 가능 (쉼표로 구분, 시군구 검색 시 시도는 검색하지 않음)
payGbCd 급여 구분 코드
payMin 최소 급여 숫자만 입력 (급여 구분이 AF:면접 후 결정 인 경우 검색하지 않음)
payMax 최대 급여 숫자만 입력 (급여 구분이 AF:면접 후 결정 인 경우 검색하지 않음)
ageGbCd 연령 구분 코드
ageMin 최소 연령 숫자만 입력 (연령 구분이 00:연령무관 인 경우 검색하지 않음)
ageMax 최대 연령 숫자만 입력 (연령 구분이 00:연령무관 인 경우 검색하지 않음)
sexCd 성별 코드
carrGbCd 경력 구분 코드
carrYear 경력 년 수 숫자만 입력 (경력 구분이 00:경력무관 인 경우 검색하지 않음)
welfareCd 복리후생 코드 다중 검색 가능 (쉼표로 구분)
primeCd 우대조건 코드 다중 검색 가능 (쉼표로 구분)
keyword 키워드 검색 다중 검색 가능 (빈칸으로 구분)
목록 결과
개발자 가이드 결과 목록 : 결과와 object, Array를 포함한 표입니다.
결과
(Json)
{ } : Object, [ ] : Array
pageNo 현재 페이지 번호
lastPage
No
마지막 페이지 번호
pageSize 페이지당 건 수
totalCount 전체 건 수
recruitList [ ] rcrtSeq 공고 식별 번호
compNm 회사명
comp
LicenseNo
사업자등록번호
rcrtTitle 채용 공고 제목
jobBg 직무 대분류
jobMd 직무 소분류
payGb 급여 구분
payMin 급여 최소 금액 (단위: 만원)
payMax 급여 최대 금액 (단위: 만원)
workSd 근무 지역 (시/도)
workSgg 근무 지역 (시/군/구)
emplType 고용 형태
educLvl 학력
career 경력
prime 우대 조건
recvStd
Ymd
접수 시작일 (YYYYMMDD)
recvEnd
Ymd
접수 마감일 (YYYYMMDD)
rcrtUrl 공고 상세 URL
상세 요청
개발자 가이드 목록 : 요청 부분과 다중검색 부분을 포함한 표입니다.
요청 URL https://job.ratis.or.kr/openapi/rcrtCont.api
항목 필수여부 설명
authKey 인증키 Y
rcrtSeq 공고 식별 번호 Y 목록 결과 참조
상세 결과
개발자 가이드 결과 목록 : 결과와 object, Array를 포함한 표입니다.
결과
(Json)
{ } : Object, [ ] : Array
recruit { } rcrtSeq 공고 식별 번호
rcrtTitle 채용 공고 제목
jobBg 직무 대분류
jobMd 직무 소분류
payGb 급여 구분
payMin 급여 최소 금액 (단위: 만원)
payMax 급여 최대 금액 (단위: 만원)
workSd 근무 지역 (시/도)
workSgg 근무 지역 (시/군/구)
workAddr 근무지 주소
workStdHm 근무 시작 시간 (HHmm)
workEndHm 근무 종료 시간 (HHmm)
workType 근무 형태
subwayInfo 인근 지하철역
summary 모집 요강
emplType 고용 형태
emplNum 고용 인원
educLvl 학력
sexGb 성별
career 경력
lang 외국어 코드 (쉼표로 구분)
langTest 외국어 공인 시험명 (쉼표로 구분)
langTestPoint 외국어 공인 시험 점수 (쉼표로 구분)
certTest 자격증 (쉼표로 구분)
lics 면허 정보
welfare 복리후생
welfare 기타 복리후생
prime 우대 조건
recvStd
Ymd
접수 시작일 (YYYYMMDD)
recvEnd
Ymd
접수 마감일 (YYYYMMDD)
rcrtUrl 공고 상세 URL
company { } compNm 회사명
compLicenseNo 사업자등록번호
compOwnerNm 대표자명
compAddr 회사 주소
compYj 업종
compYt 업태
compMakeYmd 설립일
compEmplCnt 직원수
compSalesAmt 연매출액 (단위: 만원)
compHpUrl 홈페이지 주소
목록 요청
개발자 가이드 목록 : 요청 부분과 다중검색 부분을 포함한 표입니다.
요청 URL https://job.ratis.or.kr/openapi/dataList.api
항목 필수여부 설명
authKey 인증키 Y
pageNo 페이지 번호 기본값 1
pageSize 페이지당 건 수 기본값 100, 최대 1000까지 가능
sortOrder 마감일 기준 정렬 방식 기본값 ASC (작성일 순)
- ASC : 순정렬
- DESC : 역순정렬
keyword 키워드 검색 다중 검색 가능 (빈칸으로 구분)
목록 결과
개발자 가이드 결과 목록 : 결과와 object, Array를 포함한 표입니다.
결과
(Json)
{ } : Object, [ ] : Array
pageNo 현재 페이지 번호
lastPage
No
마지막 페이지 번호
pageSize 페이지당 건 수
totalCount 전체 건 수
interviewList [ ] dataSeq 자료실 식별 번호
dataTitle 자료실 제목
dataYmd 자료실 작성일
dataUrl 자료실 상세 URL
상세 요청
개발자 가이드 목록 : 요청 부분과 다중검색 부분을 포함한 표입니다.
요청 URL https://job.ratis.or.kr/openapi/dataCont.api
항목 필수여부 설명
authKey 인증키 Y
dataSeq 자료실 식별 번호 Y 목록 결과 참조
상세 결과
개발자 가이드 결과 목록 : 결과와 object, Array를 포함한 표입니다.
결과
(Json)
{ } : Object, [ ] : Array
interview { } dataSeq 자료실 식별 번호
dataTitle 자료실 제목
dataContents 자료실 내용 (HTML)
dataYmd 자료실 작성일
dataUrl 자료실 상세 URL
에러 메세지
개발자 가이드 결과 목록 : 에러 메세지를 정리한 표입니다.
API 코드 메세지 설명
공통 01 인증키가 없습니다. 인증키 없이 API가 호출되었을 때 발생합니다.
authKey 파라미터를 확인해주세요.
02 유효하지 않은 인증키입니다. 지정한 인증키가 존재하지 않을 때 발생합니다.
인증키 발급 후 사용해주세요.
03 승인되지 않은 인증키입니다.
관리자에게 문의해주세요.
발급된 인증키가 승인되지 않았을 때 발생합니다.
99 API 요청 중 오류가 발생하였습니다.
관리자에게 문의해주세요.
정의되지 않은 기타 오류가 발생했습니다.
관리자에게 문의해주세요.
채용공고 11 채용 공고 번호가 없습니다. 채용 공고 식별 번호 없이 API가 호출되었을 때 발생합니다.
rcrtSeq 파라미터를 확인해주세요.
12 요청하신 채용 공고가 존재하지 않습니다. 지정한 채용 공고 식별 번호가 존재하지 않을 때 발생합니다.
취업자료실 31 자료 번호가 없습니다. 자료 식별 번호 없이 API가 호출되었을 때 발생합니다.
dataSeq 파라미터를 확인해주세요.
32 요청하신 자료가 존재하지 않습니다. 지정한 자료 식별 번호가 존재하지 않을 때 발생합니다.
딤 영역