한국정책방송원 개방형 영상 정보 조회 서비스 활용 가이드

1. 서비스 명세

가. 서비스 개요

서비스 정보	서비스명	한국정책방송원 개방형 영상 정보 조회 서비스
	서비스 설명	KTV 국민방송에서 방송한 영상주소, 제목, 프로그램명, 방송시간 등의 영상정보 목록을 제공하는 KTV 개방형 영상정보 조회 서비스
서비스 보안	서비스 인증/권한	없음
	메시지 레벨 암호화	없음
	전송 레벨 암호화	없음
적용 기술 수준	인터페이스 표준	REST(GET)
	교환 데이터 표준	XML
서비스 URL	https://www.ktv.go.kr/function/exp.openApi.kr
서비스 배포 정보	서비스 버전	KTV_OpenApi_20210114
	서비스 시작일	2019-06-13
	배포 일자	2019-06-13
	서비스 이력	N/A
메시지 교환 유형	Request-Response
사용 제약 사항	N/A
서비스 제공자	한국정책방송원 인터넷 방송실 박현진(044-204-8337) ktvwebmaster@korea.kr
데이터 갱신주기	실시간

나. 요청 메시지 명세

항목명(영문)	항목명(국문)	항목크기	구분	기본값	샘플데이터	항목설명
startDate	검색시작일	8	선택	sysdate	20210114	기간 검색 시작일(방송일)
endDate	검색종료일	8	선택	sysdate	20210114	기간 검색 종료일(방송일)
org	기관코드	16	선택	-	c104102	부처, 청 단위 기관코드 필터링
programId	프로그램 코드	10	선택	-	PG2170035D	프로그램 코드
order	정렬방법	4	선택	DESC	DESC	결과 목록 정렬 순서 DESC:최신순,ASC:과거순, HOT:조회수 순
count	한 페이지 결과 수	4	선택	10	15	한 페이지 결과 수
pageNo	페이지 번호	4	선택	1	2	페이지 번호
keyword	검색어	-	선택	-	정책	콘텐츠 내용, 제목 검색 (UTF-8 URL인코딩 필요)

▷ 기관, 키워드 값이 없는 경우는 1달 이내, 기관, 키워드 값이 있는 경우는 1년 이내 조회 가능

다. 응답 메시지 명세

항목명(영문)			항목명(국문)	크기	샘플데이터	상세 설명
<document> <root>			최상위 필드	-	-	응답 메시지의 시작을 알리는 최상위 필드
	<API_Version>		API 버전 정보	100	KTV_OpenApi_20210114	API 버전
	<result_Code>		결과 코드	1	1	2-나.결과 코드 항목 참고
	<result_Msg>		에러 메시지	100	정상조회	텍스트로 기술
	<total_Cnt>		결과 수	-	127	검색된 콘텐츠의 총 갯수
	<item>		콘텐츠 정보	-	-	결과 데이터 묶음
		<content_Id>	콘텐츠 ID	50	617211	해당 콘텐츠의 고유 식별 ID
		<subject>	제목	100	<![CDATA[ 3차 재난지원금 '버팀목자금', 특고도 지원 가능한가? [사실은 이렇습니다] ]]>	영상 콘텐츠의 제목
		<clsf>	대분류	20	정책뉴스	KTV 영상콘텐츠 대분류
		<clsf_code>	대분류 코드	10	100108	2-라.분류코드 항목 참고
		<category>	상세 분류	20	사회	2-라.분류코드 항목 참고
		<cate_code>	상세분류 코드	10	T000021	KTV 영상콘텐츠 상세 분류(뉴스) 코드
		<create_Date>	최초 등록일	8	20210114	콘텐츠 등록일
		<broadcast_Date>	영상 방송일	8	20210114	콘텐츠 방송일
		<update_Date>	수정 등록일		20210114	콘텐츠 수정일
		<description>	방송 내용		<![CDATA[ <p>최대환 앵커&gt; <br>계속해서 또 다른 주제 자세히 살펴보겠습니다……	방송 콘텐츠 내용 (html 형식)
		<player_url>	플레이어 주소		https://www.ktv.go.kr/content/player?content_id=617211	플레이어 주소
		<link_URL>	콘텐츠 주소	100	https://www.ktv.go.kr/content/view?content_id=617211&ref=apiKr	콘텐츠 원본 주소(KTV 홈페이지)
		<thumbnail_URL>	썸네일 주소	100	https://www.ktv.go.kr/media/contents/image/2021/01/14/mg6CLF4d6Q.jpg	영상 썸네일 이미지 URL
		<status>	콘텐츠 등록 상태 구분 코드	1	I	2-다.상태코드 항목 참고
		<program>	프로그램 명	50	<![CDATA[ 생방송 대한민국 1부 ]]>	TV 편성표 상 프로그램명
		<program_Code>	프로그램 코드	10	PG2170043D	TV 편성표 상 프로그램 코드
		<institution>	기관명	30	중소벤처기업부	영상 내용 유관 기관
		<institution_Code>	기관 코드	10	c104218	2-가.기관코드 항목 참고
		<useYn>	콘텐츠 공개 여부	1	Y	콘텐츠 공개 가능 여부
		<video_Full_YN>	전체 영상 여부	1	N	전체영상 : Y 클립영상 : N
		<view_Cnt>	조회 수	5	15	콘텐츠 누적 조회 수
		<play_Minutes>	재생 시간	4	04	영상 재생 시간(분)
		<play_Seconds>	재생 시간	4	56	영상 재생 시간(초)

2. 코드 목록

가. 기관 코드

번호	기관코드	기관명	번호	기관코드	기관명	번호	기관코드	기관명
1	c104102	청와대	21	c104133	병무청	41	c104189	교육부
2	c104105	국무총리	22	c104134	경찰청	42	c104190	외교부
3	c104103	감사원	23	c104135	소방청	43	c104191	행정안전부
4	c104104	국가정보원	24	c104136	기상청	44	c104192	농림축산식품부
5	c104107	법제처	25	c104137	문화재청	45	c104193	산업통상자원부
6	c104109	국가보훈처	26	c104138	농촌진흥청	46	c104194	국토교통부
7	c10410A	청년위원회	27	c104139	산림청	47	c104195	해양수산부
8	c104112	통일부	28	c104141	특허청	48	c104196	원자력안전위원회
9	c104114	법무부	29	c104143	해양경찰청	49	c104198	인사혁신처
10	c104115	국방부	30	c104148	공정거래위원회	50	c104208	새만금개발청
11	c104122	보건복지부	31	c104149	금융위원회	51	c104209	개인정보보호위원회
12	c104123	환경부	32	c104150	국민권익위원회	52	c104210	국가안전보장회의사무처
13	c104124	고용노동부	33	c104170	중앙선거관리위원회	53	c104211	국가지속가능발전위원회
14	c104125	여성가족부	34	c104172	행복도시건설청	54	c104212	국가테러대책위원회
15	c104128	국세청	35	c104173	기획재정부	55	c104213	민주평화통일자문회의사무처
16	c104129	관세청	36	c104176	문화체육관광부	56	c104214	지방자치발전위원회
17	c104130	조달청	37	c104180	방송통신위원회	57	c104215	행정중심복합도시건설추친위원회
18	c104131	통계청	38	c104181	국가인권위원회	58	c104216	일자리위원회
19	c104132	대검찰청	39	c104187	과학기술정보통신부	59	c104217	대통령경호처
20	c104101	방위사업청	40	c104188	식품의약품안전처	60	c104218	중소벤처기업부

나. 결과 코드

Code	메시지	코드설명
1	정상조회	정상조회
2	날짜 형식 "YYYYMMDD" 불일치	요청항목 날짜 형식 “YYYYMMDD” 불일치
3	조회 종료일이 조회 시작일 이전입니다	endDate이 startDate보다 빠름
4	조회 가능 기간 을 초과 하였습니다	조건 없는 검색 기간이 1달을 넘어감
5	조건검색 조회 가능 기간 을 초과 하였습니다	조건 있는 검색 기간이 1년을 넘어감

다. 상태 코드

Code	코드 설명
I	신규 등록된 콘텐츠
U	등록 이후 1일 이상 경과한 뒤 수정된 콘텐츠
D	저작권 문제 또는 출연자 등의 요청으로 삭제 또는 비공개 처리됨 (해당 영상을 보유하거나 표출하면 안 됨)

라. 분류 코드

clsf_code	classfication
100108	정책뉴스
100109	정책공공
100110	문화/교양
100111	특집

cate_code	category
T000019	경제
T000021	사회
T000023	문화/교양
T000024	과학
T000038	외교/안보

3. 요청/응답 메시지 예제

REST(URI)

http://www.ktv.go.kr/function/exp.openApi.kr?startDate=20190603&endDate=20190603&org=c104102&order=hot&count=10&pageNo=1&keyword=(URL Encode)정책&programId=PG2180013D

응답 메시지

<document>

<root>

<API_Version>KTV_OpenApi_20210114</API_Version>

<resultCode>1</resultCode>

<result_Msg>정상조회</result_Msg>

<total_cnt>4</total_cnt>

<item>

<content_Id>576479</content_Id>

<subject>

<![CDATA[ 문 대통령, 주한대사 17명 신임장 제정 ]]>

</subject>

<clsf>정책뉴스</clsf>

<clsf_code>100108</clsf_code>

<category>사회</category>

<cate_code>T000021</cate_code>

<create_Date>20190602</create_Date>

<broadcast_Date>20190531</broadcast_Date>

<update_Date>20190603</update_Date>

<description>

<![CDATA[

유용화 앵커&gt;<br>문재인 대통령은 오늘 오후 청와대에서 새로 부임한 주한 대사들로부터 신임장을 제정받았습니다.<br>문 대통령에게 신임장을 전한 대사는 슬로바키아와 라오스, 이탈리아 등 상주대사 5명과 보으와나, 마셜제도, 아이슬란드 등 비상주 대사 17명입니다.<br>문 대통령은 신임대사들과 기념촬영을 하고 한국과의 협력을 위해 힘써줄 것을 당부했습니다.<p>&nbsp;</p><p>&nbsp;</p><p>( KTV 국민방송 케이블방송, 위성방송 ch161, <a href="http://www.ktv.go.kr">www.ktv.go.kr</a> )<br>&lt; ⓒ 한국정책방송원 무단전재 및 재배포 금지 &gt;</p>]]>

</description>

<player_url>

<![CDATA[https://www.ktv.go.kr/content/player?content_id=${row.content_id}&ref=apiKr]]>

</player_url>

<link_URL>

https://www.ktv.go.kr/content/view?content_id=576479&ref=apiKr

</link_URL>

<thumbnail_URL>

https://www.ktv.go.kr/media/contents/image/2019/06/03/4WC9F7AWni.jpg

</thumbnail_URL>

<status>U</status>

<program>

<![CDATA[ KTV 대한뉴스 ]]>

</program>

<program_code>PG2180013D</program_code>

<institution>청와대</institution>

<institution_Code>c104102</institution_Code>

<useYn>Y</useYn>

<video_Full_YN>N</video_Full_YN>

<view_Cnt>7</view_Cnt>

<play_Minutes>00</play_Minutes>

<play_Seconds>27</play_Seconds>

</item>

</root>

</document>