JOBPLUSTV

홈
오픈API
서비스가이드
오픈API 명세서

서비스가이드

1. 요청URL

직업방송 동영상 API를 사용하기 위한 요청 URL은 아래와 같습니다.
1. 1.1 직업방송동영상 검색
  
  https://www.jobplustv.or.kr/openapi/searchm/인증키.do
2. 1.2 직업방송동영상 재생
  
  https://www.jobplustv.or.kr/openapi/playm/인증키.do
3. 1.3 분류체계 검색
  
  https://www.jobplustv.or.kr/openapi/classification/인증키.do
4. 1.4 직업정보영상분류전체목록
  
  https://www.jobplustv.or.kr/openapi/classificationall/인증키.do
5. 1.5 한국직업방송편성표
  
  https://www.jobplustv.or.kr/openapi/guideChart/인증키.do

2. 요청 파라미터

직업방송 동영상 API를 사용하기 위한 파라미터 정보는 아래와 같습니다.

2.1 직업방송동영상 검색

파라미터명	값	필수/선택	설명
query	String	선택	동영상을 검색을 원하는 질의, UTF-8 인코딩 입니다.
dt	String (PC 01, 모바일 02)	필수	직업방송 API를 사용하는 서버에 접속한 클라이언트 정보입니다.
cdType	String (기본 1, 2, 3, 4)	선택	분류검색시 검색하는 코드 타입입니다. 1=직업정보영상분류 2=진로교육영상분류 3=학과정보영상분류 4=기타영상분류
f1	String	선택	중분류 검색시 중분류 코드값입니다.
f2	String	선택	소분류 검색시 소분류 코드값입니다.
f3	String	선택	세분류 검색시 세분류 코드값입니다.
display	Integer (기본 10, 최대 100)	선택	검색결과 출력건수를 지정합니다. 최대 100까지 가능합니다.
start	Integer (기본 1, 최대 1000)	선택	검색의 시작위치를 지정할 수 있습니다. 최대 1000까지 가능합니다.
order	Integer (기본 1, 2)	선택	정렬기준을 부여합니다. 1 = 등록일자 2 = 조회수
sort	Integer (기본 1, 2)	선택	정렬방식을 정리합니다. 1 = 내림차순(desc) 2 = 오름차순(asc)
vType	String (기본 xml, json)	선택	요청결과를 수신할 view 유형입니다. xml과 json으로 받으실수있습니다..

ex) https://www.jobplustv.or.kr/openapi/searchm/인증키.do?query=worktvamp;dt=01

ex) https://www.jobplustv.or.kr/openapi/searchm/인증키.do??cdType=1amp;f1=196amp;dt=01

2.2 직업방송동영상 상세조회(재생)

파라미터명	값	필수/선택	설명
cid	String	필수	직업방송 동영상 검색시 제공되는 동영상 식별키입니다.
dt	String (PC 01, 모바일 02)	필수	직업방송 API를 사용하는 서버에 접속한 클라이언트 정보입니다.
vType	String (기본 xml, json)	선택	요청결과를 수신할 view 유형입니다. xml과 json으로 받으실수있습니다..

ex) https://www.jobplustv.or.kr/openapi/playm/인증키.do?cid=9874amp;dt=02

2.3 분류체계 검색 / 직업정보영상분류전체목록

파라미터명	값	필수/선택	설명
cdType	String (기본 1, 2, 3, 4)	선택	분류검색시 검색하는 코드 타입입니다. 1=직업정보영상분류 2=진로교육영상분류 3=학과정보영상분류 4=기타영상분류
f1	String	선택	소분류, 세분류 코드 조회시 부모코드값입니다. 직업정보영상분류 정보조회시만 사용합니다.
vType	String (기본 xml, json)	선택	요청결과를 수신할 view 유형입니다. xml과 json으로 받으실수있습니다..

직업정보영상분류 전체코드 조회) https://www.jobplustv.or.kr/openapi/classificationall/인증키.do

직업정보영상분류 중분류코드 조회) https://www.jobplustv.or.kr/openapi/classification/인증키.do

직업정보영상분류 소분류코드 조회) https://www.jobplustv.or.kr/openapi/classification/인증키.do?f1=210

학과정보영상분류코드조회) https://www.jobplustv.or.kr/openapi/classification/인증키.do?cdType=2

학과정보영상분류코드조회) https://www.jobplustv.or.kr/openapi/classification/인증키.do?cdType=3

기타영상분류코드조회) https://www.jobplustv.or.kr/openapi/classification/인증키.do?cdType=4

2.4 직업방송편성표 조회

파라미터명	값	필수/선택	설명
searchDate	String (YYYYMMDD)	필수	방송편성표를 조회할 날짜입니다.

ex) https://www.jobplustv.or.kr/openapi/guideChart/인증키.do?searchDate=20161115

3. 응답 데이터형

직업방송 동영상 API를 사용하기 위한 파라미터 정보는 아래와 같습니다.

3.1 공통

노드명			값	설명
<WORKTV>				XML문서의 최상위 노드입니다.
	<ERR_CD/>		String	에러코드 (애러코드표 참조)
	<PARAMS>		String	요청파라미터 정보
		<QUERY/>	String	동영상검색 질의어
		<F1/>	String	동영상검색 중분류 코드값
		<F2/>	String	동영상검색 소분류 코드값
		<DISPLAY/>	String	동영상검색 화면출력 갯수
		<START/>	String	동영상검색 검색시작위치
		<CID/>	String	동영상재생 식별키
		<DT/>	String	디바이스유형
	</PARAMS>		String	요청파라미터 정보
	<COUNT/>		Integer	동영상 총 검색 건수(동영상 검색api에서만 출력됩니다.)
	<ITEM/>			검색내용
</WORKTV>				XML문서의 최상위 노드입니다.

3.2 직업방송 동영상 검색

노드명			값	설명
<WORKTV>				XML문서의 최상위 노드입니다.
	<ERR_CD/>		String	에러코드 (애러코드표 참조)
	<PARAMS/>		String	요청파라미터 정보
	<COUNT/>		Integer	동영상 총 검색 건수(동영상 검색api에서만 출력됩니다.)
	<ITEM>			동영상검색내용
		<CID/>	Inteter	동영상 식별번호(동영상 PK)
		<IMG_URL/>	String	대표이미지 URL
		<CONTENT_CID_NM/>	String	동영상 제목
		<MNG_ORG/>	String	관리기관
		<SERVICE_NM/>	String	서비스명
		<REG_NM/>	String	등록자
		<MAKE_YY/>	String(YYYY)	제작년도
		<PRG_KOR_NM/>	String	프로그래명 한글명
		<PRG_ENG_NM/>	String	프로그래명 영문명
		<CONTENT_CID_SUB_NM/>	String	부제목
		<RUN_TIME/>	String	상영시간
		<BROAD_NM/>	String	방송사
		<BROAD_YYMMDD/>	String(YYYYMMDD)	방송일자
		<AUTHOR_NM/>	String	작가
		<PD_NM/>	String	PD
		<ANCHOR_NM/>	String	아나운서
		<PRODUCTION_NM/>	String	제작사
		<ACTOR_NM/>	String	출연자
		<F1_CD/>	String	중분류코드
		<F2_CD/>	String	소분류코드
		<F1_NAME/>	String	중분류코드명
		<F2_NAME/>	String	소분류코드명
		<J1_CD/>	String	진로교육동영상분류코드
		<J1_NAME/>	String	진로교육동영상분류코드명
		<H1_CD/>	String	학과정보동영상분류코드
		<H1_NAME/>	String	학과정보동영상분류코드명
		<G1_CD/>	String	기타동영상분류코드
		<G1_NAME/>	String	기타동영상분류코드명
		<NO/>	String	편
		<TOTAL_NO/>	String	총편
		<KEYWORD1/>	String	검색키워드1
		<KEYWORD2/>	String	검색키워드2
		<KEYWORD3/>	String	검색키워드3
		<KEYWORD4/>	String	검색키워드4
		<KEYWORD5/>	String	검색키워드5
	</ITEM>			동영상검색내용
	<ITEM/>			동영상검색내용
	<ITEM/>			동영상검색내용
</WORKTV>				XML문서의 최상위 노드입니다.

3.3 직업방송 동영상 상세조회(재생)

노드명			값	설명
<WORKTV>				XML문서의 최상위 노드입니다.
	<ERR_CD/>		String	에러코드 (애러코드표 참조)
	<PARAMS/>		String	요청파라미터 정보
	<ITEM>			동영상 상세 조회 내용
		<CID/>	Inteter	동영상 식별번호(동영상 PK)
		<IMG_URL/>	String	대표이미지 URL
		<CONTENT_CID_NM/>	String	동영상 제목
		<MNG_ORG/>	String	관리기관
		<SERVICE_NM/>	String	서비스명
		<REG_NM/>	String	등록자
		<MAKE_YY/>	String(YYYY)	제작년도
		<PRG_KOR_NM/>	String	프로그래명 한글명
		<PRG_ENG_NM/>	String	프로그래명 영문명
		<CONTENT_CID_SUB_NM/>	String	부제목
		<RUN_TIME/>	String	상영시간
		<BROAD_NM/>	String	방송사
		<BROAD_YYMMDD/>	String(YYYYMMDD)	방송일자
		<AUTHOR_NM/>	String	작가
		<PD_NM/>	String	PD
		<ANCHOR_NM/>	String	아나운서
		<PRODUCTION_NM/>	String	제작사
		<ACTOR_NM/>	String	출연자
		<F1_CD/>	String	중분류코드
		<F2_CD/>	String	소분류코드
		<F1_NAME/>	String	중분류코드명
		<F2_NAME/>	String	소분류코드명
		<J1_CD/>	String	진로교육동영상분류코드
		<J1_NAME/>	String	진로교육동영상분류코드명
		<H1_CD/>	String	학과정보동영상분류코드
		<H1_NAME/>	String	학과정보동영상분류코드명
		<G1_CD/>	String	기타동영상분류코드
		<G1_NAME/>	String	기타동영상분류코드명
		<NO/>	String	편
		<TOTAL_NO/>	String	총편
		<KEYWORD1/>	String	검색키워드1
		<KEYWORD2/>	String	검색키워드2
		<KEYWORD3/>	String	검색키워드3
		<KEYWORD4/>	String	검색키워드4
		<KEYWORD5/>	String	검색키워드5
		<STREAMING_URL/>	String	RTMP 스트리밍 재생 URL 입니다.
		<IPHONE_STREAMING_URL/>	String	iphone, ipad, ipod용 RTMP 스트리밍 재생 URL 입니다.
		<DESC/>	CDATA	동영상 설명
		<HLS_STREAMING_URL/>	String	HLS 스트리밍 재생 URL 입니다.
	</ITEM>			동영상 상세 조회 내용
</WORKTV>				XML문서의 최상위 노드입니다.

3.4 분류체계 검색

노드명			값	설명
<WORKTV>				XML문서의 최상위 노드입니다.
	<ERR_CD/>		String	에러코드 (애러코드표 참조)
	<PARAMS/>		String	요청파라미터 정보
	<COUNT/>			검색건수
	<ITEM>			분류체계 검색 결과
		<C_ID/>	Inteter	분류체계 코드
		<C_NAME/>	String	분류체계코드명
		<C_PID/>	Inteter	상위분류체계코드
	</ITEM>			분류체계 검색 결과
	<ITEM/>			분류체계 검색 결과
	<ITEM/>			분류체계 검색 결과
</WORKTV>				XML문서의 최상위 노드입니다.

3.5 방송편성표 검색

노드명			값	설명
<WORKTV>				XML문서의 최상위 노드입니다.
	<ERR_CD/>		String	에러코드 (애러코드표 참조)
	<PARAMS/>		String	요청파라미터 정보
	<COUNT/>			검색건수
	<ITEM>			편성 프로그램
		<PROGRAM_URL/>	String	방송프로그램 URL
		<PROGRAM_KEY/>	String	프로그램 식별번호(프로그램 PK)
		<PROGRAM_NAME/>	String	프로그램명
		<IS_REP_PROGRAM/>	String	대표프로그램 여부
		<AIR_TIME/>	String	시
		<AIR_MINUTE/>	String	분
	</ITEM>			편성 프로그램
</WORKTV>				XML문서의 최상위 노드입니다.

4. Result Code

직업방송 동영상 API를 사용하기 위한 파라미터 정보는 아래와 같습니다.

4.1 에러코드

Code	description
WTV-000	API호출 성공
WTV-001	입력 파라미터 오류
WTV-002	인증키 오류
WTV-003	인증키 사용기간 오류
WTV-004	승인받지 않는 인증기

JOBPLUSTV

전체메뉴보기

홈으로

JOBPLUSTV소개

프로그램

취업

정보마당

로그인

회원가입

서비스가이드