OpenAPI활용가이드(한국노인인력개발원_100세누리구인정보)_v1.1.docx
본문 바로가기
좋은 건강

OpenAPI활용가이드(한국노인인력개발원_100세누리구인정보)_v1.1.docx

by 정진한 2024. 1. 10.
반응형

 

 

 

 

 

 

 

공공데이터 개방•공유•활용 체계 개발

OpenAPI 활용가이드

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

문서 정보

프로젝트 한국노인인력개발원 OpenAPI 개발
단계 적용
활동 적용
작업 활용가이드작성
산출물 OpenAPI 활용가이드
파일명 OpenAPI활용가이드(한국노인인력개발원_100세누리구인정보)_v1.0.docx

 

 

 

개정 이력

버 전 변경일 변경 사유 변경 내용 작성자 승인
1.0 2016-12-12 최초작성 최초작성 김지은  
           
           
           
           

 

 

 

 

 

 

                                                                                                                  

 

 

 

 

 

 

                                                     

 

 
목 차

 

1. 서비스 개요... 4

1.1 OpenAPI 서비스 개요... 4

가. 배경 및 필요성... 4

나. OpenAPI 서비스 설명... 4

1.2. 기대효과... 4

2. 서비스 목록... 8

3. 서비스 명세... 8

4.1 100세누리 구인정보... 8

가. 서비스 개요... 8

나. 오퍼레이션 목록... 9

다. Open API 에러 코드 정리... 18

 

 

 

 

1. 서비스 개요

1.1 OpenAPI 서비스 개요

가. 배경 및 필요성

(1) 노인의 자립능력 향상 및 소득보전을 위한 근로 소득 창출 기회제공

(2) 각 부처에서 시행중인 일자리 사업에 포함되지 않은 사각지대의 60세 이상자를 대상으로 한 민간일자리 사업 정보 제공

나. OpenAPI 서비스 설명

100세누리 시니어활동포털에서 제공하는 60세이상을 대상으로 한 노인구인정보를 제공하여 민간이 쉽게 활용할 수 있도록 표준화 방식으로 개방한 공유서비스

 

1.2. 기대효과

(1) 민간 노인일자리 모집정보 등을 일반 개발자에 공개하여 대국민의 접근성을 높이는 서비스

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

3. 서비스 목록

순번 서비스명(국문) 서비스명(영문)
1 100세누리 구인정보 SenuriService

※ 오퍼레이션 목록은 각각의 서비스 명세에 표기

4.서비스 명세

4.1 100세누리 구인정보

가. 서비스 개요

서비스 정보 서비스명(국문) 100세누리 구인정보
서비스명(영문) SenuriService
서비스 설명 한국노인인력개발원에서 100세누리 포털에서 제공하는 노인일자리 구인정보 중 저작권에 위배되지 않는 정보를 제목, 고용형태, 근무지별로 채용공고 리스트를 조회하고, 채용공고 ID로 상세 정보를 조회하는 100세누리 구인정보 제공 API 서비스
서비스 설명
(영문)		 The 100-year-old Nuri Portal provides information on job openings provided by Nuri Portal, a 100-year-old Nuri Portal, and information on non-copyright infringement by title, employment type, and workplace, Job offer service API service
API 서비스 보안
적용 기술 수준		 서비스 인증/권한 [O] 서비스 Key[ ] 인증서 (GPKI)
[] Basic (ID/PW) [ ] 없음
메시지 레벨
암호화		 [  ] 전자서명     [ ] 암호화          [O] 없음
전송 레벨 암호화 [  ] SSL                       [ O] 없음
인터페이스 표준 [  ] SOAP 1.2
(RPC-Encoded, Document Literal, Document Literal Wrapped)
[ O ] REST (GET)
[ ] RSS 1.0 [ ] RSS 2.0 [ ] Atom 1.0 [ ] 기타
교환 데이터 표준 [ O ] XML          [ ] JSON [ ] MIME [ ] MTOM
API 서비스
배포 정보		 서비스URL http:// apis.data.go.kr/B552474/SenuriService
서비스 WADL http:// apis.data.go.kr/B552474/SenuriService?_wadl&type=xml
서비스 버전 1.0
서비스 시작일 2016-12-23 서비스 배포일 2016-12-23
서비스 이력 2016-12-23 : 서비스 시작
메시지 교환 유형 [O] Request-Response     [ ] Publish-Subscribe
[ ] Fire-and-Forgot                    [ ] Notification
서비스 제공자 김종태 / 한국노인인력개발원 정보통계부 /
031-8035-7592 / sky_flow@kordi.go.kr
데이터 갱신주기 일 1회

 

나. 오퍼레이션 목록

일련번호 서비스명(국문) 오퍼레이션명(영문) 오퍼레이션명(국문)
1 100세누리 구인정보 getJobList 100세누리 구인정보 목록 검색
2 getJobInfo 100세누리 구인정보 상세 정보 조회

 

(1)  [100세누리 구인정보 목록 검색] 오퍼레이션 명세

오퍼레이션 정보 오퍼레이션 번호 1 오퍼레이션명(국문) 100세누리 구인정보 목록 검색
오퍼레이션 유형 조회(목록) 오퍼레이션명(영문) getJobList
오퍼레이션 설명 채용공고 제목, 고용형태, 근무지를 이용하여 체용공고 제목, 근무지, 사업장명, 시작접수일, 종료접수일 등 구인정보 목록을 조회하는 기능
오퍼레이션 설명
(영문)		 Ability to look up job information list including job title, job title, job title, work place, start date, and end date using job title, job type, and work location
Call Back URL http:// apis.data.go.kr/B552474/SenuriService/getJobList
최대 메시지 사이즈 [ 1197   bytes]
평균 응답 시간 [         500           ms] 초당 최대 트랜잭션 [         30        tps]

 

① 요청 메시지 명세

항목명(영문) 항목명(국문) 항목크기 항목구분 샘플데이터 항목설명
serviceKey 인증키 100 1 인증키(URL-Encode) 공공데이터포털에서 발급받은 인증키
pageNo 페이지번호 4 1 1 페이지번호
numOfRows 한 페이지 결과 수 4 1 10 한 페이지 결과 수
search 검색 1000 0 전시장 검색
emplymShp 채용공고 고용형태 6 0 CM0103 채용공고 고용형태
CM0101 : 정규직
CM0102 : 계약직
CM0103 : 시간제일자리
CM0104 : 일당직
CM0105 : 기타
workPlcNm 근무지명 50 0 중구 근무지명

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

 

② 응답 메시지 명세

항목명(영문) 항목명(국문) 항목크기 항목구분 샘플데이터 항목설명
resultCode 결과코드 4 1 0000 결과코드
resultMsg 결과메시지 50 1 OK 결과메시지
pageNo 페이지 수 4 1 1 페이지 수
totalCount 데이터 총 개수 4 1 17 데이터 총 개수
acptMthd 접수방법 2000 0 이메일 접수방법
deadline 마감여부 1 0 마감 마감여부
emplymShp 채용공고 고용형태 6 0 CM0103 채용공고 고용형태
CM0101 : 정규직
CM0102 : 계약직
CM0103 : 시간제일자리
CM0104 : 일당직
CM0105 : 기타
emplymShpNm 채용공고형태명 6 0 시간제일자리 채용공고형태명
frDd 시작접수일 7 0 20160921 시작접수일
jobId 채용공고ID 20 0 RECR_000000000013950 채용공고ID
jobcls 직종 50 0 A08009 직종
jobclsNm 직종명 50 0 기타 직종명
oranNm 기업명 50 0   기업명
organYn 구분값 1 0 N 대민 : N
업무 : Y
recrtTitle 채용제목 1000 0 [서울시립미술관 르누아르전] 전시장 지킴이 모집 채용제목
stmId 시스템ID 1 0 A A :100세누리
B :워크넷
C:일모아
stmNm 시스템명 1 0 100세누리 시스템명
toDd 종료접수일 7 0 20161007 종료접수일
workPlc 근무지 50 0 010240 근무지명(workPlcNm)의 값
workPlcNm 근무지명 50 0 중구 근무지명

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

 

③ 요청 / 응답 메시지 예제

REST(URI)
http://apis.data.go.kr/B552474/SenuriService/getJobList?ServiceKey=인증키&numOfRows=1&pageNo=1
응답 메시지
                               
response>
<header>
<resultCode>00</resultCode>
<resultMsg>NORMAL SERVICE.</resultMsg>
</header>
<body>
<items>
<item>
<acptMthd>이메일</acptMthd>
<deadline>마감</deadline>
<emplymShp>CM0103</emplymShp>
<emplymShpNm>시간제일자리</emplymShpNm>
<frDd>20160921</frDd>
<jobId>RECR_000000000013950</jobId>
<jobcls>A08009</jobcls>
<jobclsNm>기타</jobclsNm>
<organYn>N</organYn>
<recrtTitle>[서울시립미술관 르누아르전] 전시장 지킴이 모집</recrtTitle>
<stmId>A</stmId>
<stmNm>100세누리</stmNm>
<toDd>20161007</toDd>
<workPlc>010240</workPlc>
<workPlcNm>중구</workPlcNm>
</item>
<item>
<acptMthd>방문</acptMthd>
<deadline>마감</deadline>
<emplymShp>CM0105</emplymShp>
<emplymShpNm>기타</emplymShpNm>
<frDd>20160713</frDd>
<jobId>RECR_000000000013490</jobId>
<jobcls>A01003</jobcls>
<jobclsNm>영업/판매</jobclsNm>
<oranNm>가인.기성콘테이너</oranNm>
<organYn>N</organYn>
<recrtTitle>스티커 작업</recrtTitle>
<stmId>A</stmId>
<stmNm>100세누리</stmNm>
<toDd>20160831</toDd>
<workPlc>150130</workPlc>
<workPlcNm>천안시</workPlcNm>
</item>
<item>
<acptMthd>온라인</acptMthd>
<deadline>마감</deadline>
<emplymShp>CM0101</emplymShp>
<emplymShpNm>정규직</emplymShpNm>
<frDd>20160623</frDd>
<jobId>RECR_000000000013311</jobId>
<jobcls>A04004</jobcls>
<jobclsNm>육아/보육</jobclsNm>
<oranNm>(주)씨씨팩토리</oranNm>
<organYn>N</organYn>
<recrtTitle>실내놀이터 - 놀이 선생님 모집</recrtTitle>
<stmId>A</stmId>
<stmNm>100세누리</stmNm>
<toDd>20160630</toDd>
<workPlc>010180</workPlc>
<workPlcNm>송파구</workPlcNm>
</item>
<item>
<acptMthd>방문</acptMthd>
<deadline>마감</deadline>
<emplymShp>CM0101</emplymShp>
<emplymShpNm>정규직</emplymShpNm>
<frDd>20160623</frDd>
<jobId>RECR_000000000013310</jobId>
<jobcls>A04004</jobcls>
<jobclsNm>육아/보육</jobclsNm>
<organYn>N</organYn>
<recrtTitle>실내놀이터 - 보드게임 선생님 모집</recrtTitle>
<stmId>A</stmId>
<stmNm>100세누리</stmNm>
<toDd>20160630</toDd>
<workPlc>010180</workPlc>
<workPlcNm>송파구</workPlcNm>
</item>
<item>
<acptMthd>온라인</acptMthd>
<deadline>마감</deadline>
<emplymShp>CM0102</emplymShp>
<emplymShpNm>계약직</emplymShpNm>
<frDd>20160427</frDd>
<jobId>RECR_000000000012580</jobId>
<jobcls>A02001</jobcls>
<jobclsNm>경비원</jobclsNm>
<oranNm>시스윈일렉트로닉스</oranNm>
<organYn>N</organYn>
<recrtTitle>건물 청소 / 경비</recrtTitle>
<stmId>A</stmId>
<stmNm>100세누리</stmNm>
<toDd>20160506</toDd>
<workPlc>030530</workPlc>
<workPlcNm>화성시</workPlcNm>
</item>
<item>
<acptMthd>방문</acptMthd>
<deadline>마감</deadline>
<emplymShp>CM0103</emplymShp>
<emplymShpNm>시간제일자리</emplymShpNm>
<frDd>20160408</frDd>
<jobId>RECR_000000000012390</jobId>
<jobcls>A01001</jobcls>
<jobclsNm>생산/제조</jobclsNm>
<oranNm>(주)자인에프앤이</oranNm>
<organYn>N</organYn>
<recrtTitle>생산직 직원을 모집합니다.</recrtTitle>
<stmId>A</stmId>
<stmNm>100세누리</stmNm>
<toDd>20160429</toDd>
<workPlc>030170</workPlc>
<workPlcNm>부천시오정구</workPlcNm>
</item>
<item>
<acptMthd>방문</acptMthd>
<deadline>마감</deadline>
<emplymShp>CM0101</emplymShp>
<emplymShpNm>정규직</emplymShpNm>
<frDd>20160127</frDd>
<jobId>RECR_000000000010840</jobId>
<jobcls>A02001</jobcls>
<jobclsNm>경비원</jobclsNm>
<oranNm>(주)한결티오스</oranNm>
<organYn>N</organYn>
<recrtTitle>역삼동 올림피아빌딩 경비원 구인</recrtTitle>
<stmId>A</stmId>
<stmNm>100세누리</stmNm>
<toDd>20160229</toDd>
<workPlc>010010</workPlc>
<workPlcNm>강남구</workPlcNm>
</item>
<item>
<acptMthd>방문</acptMthd>
<deadline>마감</deadline>
<emplymShp>CM0103</emplymShp>
<emplymShpNm>시간제일자리</emplymShpNm>
<frDd>20160127</frDd>
<jobId>RECR_000000000010850</jobId>
<jobcls>A05006</jobcls>
<jobclsNm>커피숍/바리스타</jobclsNm>
<oranNm>남구노인인력개발센터</oranNm>
<organYn>N</organYn>
<recrtTitle>지브라운 청운대점</recrtTitle>
<stmId>A</stmId>
<stmNm>100세누리</stmNm>
<toDd>20160127</toDd>
<workPlc>110030</workPlc>
<workPlcNm>남구</workPlcNm>
</item>
<item>
<acptMthd>팩스</acptMthd>
<deadline>마감</deadline>
<emplymShp>CM0102</emplymShp>
<emplymShpNm>계약직</emplymShpNm>
<frDd>20160112</frDd>
<jobId>RECR_000000000010750</jobId>
<jobcls>A02002</jobcls>
<jobclsNm>건물/시설 관리</jobclsNm>
<oranNm>(주)다전디자인그룹</oranNm>
<organYn>N</organYn>
<recrtTitle>4층짜리 근린생활 빌딩관리하실 분</recrtTitle>
<stmId>A</stmId>
<stmNm>100세누리</stmNm>
<toDd>20160121</toDd>
<workPlc>010150</workPlc>
<workPlcNm>서초구</workPlcNm>
</item>
</items>
<numOfRows>10</numOfRows>
<pageNo>1</pageNo>
<totalCount>18</totalCount>
</body>
</response>

(2) (100세누리 구인정보 상세 정보 조회] 오퍼레이션 명세

오퍼레이션 정보 오퍼레이션 번호 2 오퍼레이션명(국문) 100세누리 구인정보 상세 정보 조회
오퍼레이션 유형 조회(상세) 오퍼레이션명(영문) getJobInfo
오퍼레이션 설명 채용공고 ID를 이용하여 채용공고 제목, 근무지, 사업장명, 시작접수일, 종료접수일 등 구인정보 상세 내용을 조회하는 기능
오퍼레이션 설명
(영문)		 The job posting ID is used to inquire job posting details such as the body announcement title, workplace, business name, start acceptance date, and end acceptance date
Call Back URL http:// apis.data.go.kr/B552474/SenuriService/getJobInfo
최대 메시지 사이즈 [ 4000bytes 이상]
평균 응답 시간 [         500           ms] 초당 최대 트랜잭션 [         30        tps]

 

① 요청 메시지 명세

항목명(영문) 항목명(국문) 항목크기 항목구분 샘플데이터 항목설명
serviceKey 인증키 100 1 인증키(URL-Encode) 공공데이터포털에서 발급받은 인증키
id 채용공고ID 20 1 K150011505260033 getJobList의 jobId값

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

 

② 응답 메시지 명세

항목명(영문) 항목명(국문) 항목크기 항목구분 샘플데이터 항목설명
acptMthdCd 접수방법 6 0 CM0804 접수방법
CM0801          온라인
CM0802          이메일
CM0803          팩스
CM0804          방문
age 연령 2 0 20 연령
ageLim 연령제한 1 0 제한 연령제한
clerk 담당자 50 0 이동운외2명 담당자
clerkContt 담당자연락처 15 0 070-4005-2721 담당자연락처
clltPrnnum 채용공고 모집인원 4 0 1 채용공고 모집인원
createDy 생성일자 7 0 2015-05-26T10:56:51+09:00 생성일자
detCnts 상세내용 4000 0 산후조리원 및 산부인과 주방보조/첫째날10:30~19:00까지 /둘째날07:00-19:00/셋째날07:00-14:30/4일째 휴무/ 4일째는 휴무/4명의 조리사분중 1분 채용/급여협의120-140 상세내용
etcItm 기타사항 4000 0 장년우대 기타사항
frAcptDd 시작접수일 7 0 20150526 시작접수일
homepage 홈페이지 100 0 http://myb-ob.co.kr 홈페이지
jobId 채용공고ID 20 1 K150011505260033 채용공고ID
lnkStmId 연계시스템ID 1 0 B A :100세누리
B :워크넷
C:일모아
organYn 구분값 1 0 N 대민 : N
업무 : Y
plDetAddr 주소 200 0 405-825 인천광역시 남동구 논고개로123번길 17, 아이플렉스701호~705호,712호~714호 (논현동) 주소
plbizNm 사업장명 1000 0 마이비산부인과마이비산후조리원 사업장명
repr 담당자 50 0 이동운외2명 담당자
stmId 시스템ID 1 0 A A :100세누리
B :워크넷
C:일모아
toAcptDd 종료접수일 7 0 20150724 종료접수일
updDy 변경일자 7 0 2015-07-24T03:11:25+09:00 변경일자
wantedAuthNo 구인인증번호 20 0 K150011505260033 채용공고 ID 값
wantedTitle 채용제목 1000 0 산후조리원 주방조리사 모집 채용제목

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

 

③ 요청 / 응답 메시지 예제

REST(URI)
http:// apis.data.go.kr/B552474/SenuriService/getJobInfo?ServiceKey=인증키&id=채용공고ID
응답 메시지
<response>
<header>
<resultCode>00</resultCode>
<resultMsg>NORMAL SERVICE.</resultMsg>
</header>
<body>
<item>
<acptMthdCd>CM0804</acptMthdCd>
<age>60</age>
<ageLim>제한</ageLim>
<clerk>이동운외2명</clerk>
<clerkContt>070-4005-2721</clerkContt>
<clltPrnnum>1</clltPrnnum>
<createDy>2015-05-26T10:56:51+09:00</createDy>
<detCnts>
산후조리원 및 산부인과 주방보조/첫째날10:30~19:00까지 /둘째날07:00-19:00/셋째날07:00-14:30/4일째 휴무/ 4일째는 휴무/4명의 조리사분중 1분 채용/급여협의120-140
</detCnts>
<etcItm>장년우대</etcItm>
<frAcptDd>20150526</frAcptDd>
http://myb-ob.co.kr
<jobId>K150011505260033</jobId>
<lnkStmId>B</lnkStmId>
<organYn>N</organYn>
<plDetAddr>
405-825 인천광역시 남동구 논고개로123번길 17, 아이플렉스701호~705호,712호~714호 (논현동)
</plDetAddr>
<plbizNm>마이비산부인과마이비산후조리원</plbizNm>
<repr>이동운외2명</repr>
<stmId>A</stmId>
<toAcptDd>20150724</toAcptDd>
<updDy>2015-07-24T03:11:25+09:00</updDy>
<wantedAuthNo>K150011505260033</wantedAuthNo>
<wantedTitle>산후조리원 주방조리사 모집</wantedTitle>
</item>
</body>
</response>
 

 

다. Open API 에러 코드 정리

에러코드 에러메세지 설명
0 NORMAL_CODE 정상
1 APPLICATION_ERROR 어플리케이션 에러
2 DB_ERROR 데이터베이스 에러
3 NODATA_ERROR 데이터없음 에러
4 HTTP_ERROR HTTP 에러
5 SERVICETIMEOUT_ERROR 서비스 연결실패 에러
10 INVALID_REQUEST_PARAMETER_ERROR 잘못된 요청 파라메터 에러
11 NO_MANDATORY_REQUEST_PARAMETERS_ERROR 필수요청 파라메터가 없음
12 NO_OPENAPI_SERVICE_ERROR 해당 오픈API서비스가 없거나 폐기됨
20 SERVICE_ACCESS_DENIED_ERROR 서비스 접근거부
21 TEMPORARILY_DISABLE_THE_SERVICEKEY_ERROR 일시적으로 사용할 수 없는 서비스 키
22 LIMITED_NUMBER_OF_SERVICE_REQUESTS_EXCEEDS_ERROR 서비스 요청제한횟수 초과에러
30 SERVICE_KEY_IS_NOT_REGISTERED_ERROR 등록되지 않은 서비스키
31 DEADLINE_HAS_EXPIRED_ERROR 기한만료된 서비스키
32 UNREGISTERED_IP_ERROR 등록되지 않은 IP
33 UNSIGNED_CALL_ERROR 서명되지 않은 호출
99 UNKNOWN_ERROR 기타에러

 

반응형
저작자표시

'좋은 건강' 카테고리의 다른 글

뜨거운 맹물 맛도 건강도 좋네요  (0) 2024.01.19
복식 호흡법, 어르신 건강  (0) 2024.01.17
(좋은 건강) MRI와 CT의 차이점  (0) 2023.11.17
제철음식, 자연을 순응하면 최고의 건강을 선물해준다.  (0) 2023.11.01
기침, 만성 기관지염  (0) 2023.10.31

관련글

티스토리툴바