DAUM 뉴스송고API 기술가이드 문서 (2011/12/23 개정본)

뉴스송고API 기술가이드 문서 (2011/12/23 개정본)

Open API 2010/01/25 16:49

0. 기술가이드 개정

- 2011년 12월 23일 개정된 기술 가이드를 공지하였으며, 2012년 1월 15일 접수분부터 개정된 가이드를 따름
- 2012년 1월 14일 이전에 제휴 및 적용이 완료된 매체는 기존 기술방식으로 기사 송고 가능
   단, xml 패턴 수정 등 제휴된 내용에서 변경이 필요할 경우 개정된 기술 가이드를 따라야함

1. 'view 추천 위젯 송고'에 대하여
- 추천위젯송고는 '기사 페이지에 view 추천위젯을 적용하여 복잡한 절차 없이 기사를 송고할 수 있는 기술적 방법'
- 추천위젯을 적용하면 해당 추천위젯이 첫 로딩될 때 기사가 송고됨 (무단으로 추천버튼 삭제할 경우 제휴 종료)
- 일 기사 송고량은 2000건으로 제한함

2. view 서비스 가입
- http://v.daum.net/user/join 에서 가입(외부 블로그 선택 후 언론사 URL 입력)
- xml 제작 및 테스트 완료 후 Daum view 제휴 담당자(webnews@daumcorp.com)에게 테스트 내용과 view가입아이디 전달
- Daum view 관리자가 내용 검토 후 승인 (승인 전 송고 불가)

※ 메일 작성 요령
메일 제목 : [XML테스트 완료]+ 매체명
메일 내용 : 테스트를 진행한 원문기사url,  원문기사url에 대응하는 xml url, 가입아이디
(xml 제작 및 테스트 방법은 아래 '7장 메타 정보 제공을 위한  XML 포맷' 참고)

3. 추천위젯 송고방법
 - 송고할 기사 페이지에 추천위젯을 아래와 같이 정확하게 삽입

<embed src="http://api.v.daum.net/static/recombox1_newscp.swf?nurl={인코딩 된 기사 URL}&xml_url={인코딩 된 기사의 XML URL}&channel={해당기사의 view 채널 영문명}" quality="high" bgcolor="#ffffff" width="400" height="80"type="application/x-shockwave-flash"></embed>

만약
기사 URL이 http://www.abc.co.kr/article/view?id=123  이고,
대응 XML URL이 http://www.abc.co.kr/article/xml?id=123 이며,
view의 인터넷 채널에 송고하고자 한다면

<embed src="http://api.v.daum.net/static/recombox1_newscp.swf?nurl=http%3A%2F%2Fwww.abc.co.kr%2Farticle%2Fview%3Fid%3D123&xml_url=http%3A%2F%2Fwww.abc.co.kr%2Farticle%2Fxml%3Fid%3D123&channel=internet" quality="high" bgcolor="#ffffff" width="400" height="80"type="application/x-shockwave-flash"></embed>

위처럼 삽입합니다.

nurl	xml_url	channel
- 송고하고자 하는 실제 기사의 인코딩된 url	- 송고하고자 하는 기사에 대응하는 xml의 url	송고하고자 하는 view 채널 영문명
- xml url 아님, 인코딩 필수	- 기사 url 아님, 인코딩 필수	(5. Daum view 송고가능 채널 참고)
- 기사는 고정된 한개의 주소만 가져야 함	- xml 제작 및 테스트 방법은 아래 '7장 메타 정보 제공을 위한  XML 포맷' 참고
송고불가 예시)                                       http://abc.co.kr/article/view?id=1234&category=it                                     http://abc.co.kr/article/view?id=1234&category=it& =>같은 기사가 &의 차이로 2개의 url이 생성되어 중복 송고, 발견시 경고 부과 및 제휴 종료 사유

4. 추천위젯 모양 수정 방법
- 추천위젯 모양의 수정을 원하시는 경우, 송고할 콘텐츠에 삽입된 추천 위젯 주소를 변경해 적용할 수 있음

1번 :     

2번 :     

3번 :         4번 :      

- (1)번 추천위젯을 (3)번 모양으로 바꾸고자 한다면 , 소스의 'recombox1'을 'recombox3' 으로 변경하면 됨

<embed src="http://api.v.daum.net/static/recombox1_newscp.swf?nurl=http%3A%2F%2Fwww.abc.co.kr%2Farticle%2Fview%3Fid%3D123&xml_url=http%3A%2F%2Fwww.abc.co.kr%2Farticle%2Fxml%3Fid%3D123&channel=internet" quality="high" bgcolor="#ffffff" width="400" height="80"type="application/x-shockwave-flash"></embed>

↓  'recombox3'으로 변경
 

<embed src="http://api.v.daum.net/static/recombox3_newscp.swf?nurl=http%3A%2F%2Fwww.abc.co.kr%2Farticle%2Fview%3Fid%3D123&xml_url=http%3A%2F%2Fwww.abc.co.kr%2Farticle%2Fxml%3Fid%3D123&channel=internet" quality="high" bgcolor="#ffffff" width="400" height="80"type="application/x-shockwave-flash"></embed>

 

 

5. Daum view 송고가능 채널
- Daum view에 송고할 수 있는 채널 목록 (반드시 영문명으로 사용해야 송고 가능, 한글 설정 시 송고 오류)

채널 한글명	채널 영문명	채널 한글명	채널 영문명	채널 한글명	채널 영문명	채널 한글명	채널 영문명
일상다반사	lifestory	재미	humor	게임	game	생활경제	money
취미	hobby	TV	tv	인터넷	internet	주식펀드	stock
요리	recipe	스타	star	카메라	camera	부동산	estate
맛집	restaurant	영화	movie	모바일	mobile	자동차	car
여행	travel	음악	music	축구	soccer	비즈니스	business
연애	love	책	book	해외축구	worldsoccer	취업직장	job
패션뷰티	fashion	만화	ani	야구	baseball	사회	society
건강	health	공연전시	theater	해외야구	worldbaseball	정치	politics
육아	childcare	창작	series	농구	basketball	국제	world
반려동물	pet	문화	culture	배구	volleyball	미디어	media
군대	army	IT	it	골프	golf	교육	education
해외생활	global	과학	science	스포츠일반	sportsgeneral

6. 기사삭제
- My view 페이지에서 삭제 가능(http://v.daum.net/my/{daumid})
- 기사삭제 : My view에서 해당 기사 삭제, 삭제 시 뉴스 검색에 반영됨
- 기사수정 : 기사 수정 불가, My view에서 해당 기사 목록 삭제 후 새로운 URL로 재송고하여야 뉴스 검색에 반영됨. 같은 URL은 송고되지 않음

7. 메타 정보 제공을 위한 XML 포맷
- 송고컨텐츠와 XML은 1:1로 대응되어야함
- 메타데이터를 확인 할 수 있도록 아래 가이드를 준수해야 함
- [http://api.v.daum.net/newscp/validation]에 접속하여 XML에 대한 사전 송고테스트 필수
- 푸른색 표시된 항목을 제외한 모든 내용 필수

항목				설  명
1	2	3	4
NEWS	act			기사 입력, 수정, 삭제에 관한 정보
				(현재는 act="C" 만 허용: create)
	orgid			언론사 사용 기사 식별 번호. 수정/삭제 시 필요
	ver			NewsML 버전 "1.1" 고정
DATETIME				연월일시분초 8자리 형식으로 정리된 기사 생성 날짜/시간 형식에 맞지 않을 시 송고 불가
				예) 2011년 3월 17일 오후 1시 30분 -> <DATETIME>20110317133000</DATETIME>
WRITER _LIST	WRITER	NAME		기자명 기입(예: 홍길동). 기자이름 외 추가 정보 기입시 기자명으로 검색 불가능 (예:홍길동 기자)
		EMAIL		기자 e-mail 주소
CATEGORY_ LIST	CODE			기사 카테고리 분류 정보(view카테고리 영문명)
TITLE				기사 제목, 누락 시 검색 연동 불가
SUB_TITLE				기사 부제목
TEXT				기사 본문, 누락 시 검색 연동 불가
IMG_LIST	※ IMG_LIST는 옵션이나 IMG_LIST를 넣을 경우 IMG 정보  1개 이상 필수
	IMG	URL		이미지 URL 또는 이미지 파일명
		DESC		이미지에 대한 설명(설명이 있을 경우에만 적용)
VOD_LIST	※ VOD_LIST는 옵션이나 VOD_LIST를 넣을 경우 VOD 정보  1개 이상 필수
	VOD			동영상 URL
EXT	OUTLINK			기사 원문 URL. 반드시 송고하는 기사 원문 URL과 동일 해야함. 다를 경우 삭제 및 경고
	COPYRIGHT			기사 저작권 문구
	RELATED_ NEWS_LIST	※ RELATED_NEWS_LIST는 옵션이나 RELATED_NEWS_LIST를 넣을 경우 RELATED_NEWS 정보  1개 이상 필수
		RELATED_ NEWS	SUBJECT	언론사 제공 관련기사의 제목
			RELATED_NEWS_URL	언론사 제공 관련기사의 URL

※ XML은 반드시 유효(valid)한 문서이고 선언부에 DTD를 포함하여야 함 (아래 예시 참고)
※ IMG_LIST의 경우 첫번째 데이터만 사용, 추후 필요할 경우 나머지 데이터 사용 가능함
※ 푸른색 표시 항목은 옵션, 나머지는 모두 필수

※ 아래 예시 참고(예시에 따라 CDATA TAG 포함하여야 함)

<?xml version="1.0" encoding="utf-8"?>

<!DOCTYPE NEWS

        PUBLIC "-//view.daum.net//DTD NewsML 1.1//EN"

        "http://api.v.daum.net/static/dtd/newsml-1.1.dtd">

<NEWS ver="1.1" act="C" orgid="182629">

    <DATETIME>20070201210000</DATETIME>

    <WRITER_LIST>

        <WRITER>

            <NAME><![CDATA[기자명]]></NAME>

            <EMAIL>abcd@abc.com</EMAIL>

        </WRITER>

    </WRITER_LIST>

    <CATEGORY_LIST>

        <CODE>soccer</CODE>

    </CATEGORY_LIST>

    <TITLE><![CDATA[FIA, 2009시즌 F1 그랑프리 공식 일정 발표]]></TITLE>

    <SUB_TITLE><![CDATA[작은 제목]]></SUB_TITLE>

    <TEXT><![CDATA[올시즌 보다 2경기 줄어 17경기 소화…프랑스, 캐나다 포기의사 밝혀 2009시즌 F1 그랑프리 공식 일정이 확정됐다.]]>

    </TEXT>

    <IMG_LIST>

        <IMG>

            <URL><![CDATA[http://이미지가/있는/서버/주소/1342968.jpg]]></URL>

            <DESC><![CDATA[이미지 설명]]></DESC>

        </IMG>

        <IMG>

            <URL><![CDATA[http://이미지가/있는/서버/주소/1342968.jpg]]></URL>

            <DESC><![CDATA[이미지 설명]]></DESC>

        </IMG>

    </IMG_LIST>

    <VOD_LIST>

        <VOD><![CDATA[http://동영상이/있는/서버/주소/20070201_13.wmv]]></VOD>

    </VOD_LIST>

    <EXT>

        <OUTLINK><![CDATA[http://해당/기사/언론사측/주소/]]></OUTLINK>

        <COPYRIGHT><![CDATA[저작권 문구]]></COPYRIGHT>

        <RELATED_NEWS_LIST>

            <RELATED_NEWS>

                <SUBJECT><![CDATA[관련기사제목]]></SUBJECT>

                <RELATED_NEWS_URL><![CDATA[http://해당/기사/언론사측/주소/]]></RELATED_NEWS_URL>

            </RELATED_NEWS>

            <RELATED_NEWS>

                <SUBJECT><![CDATA[관련기사제목]]></SUBJECT>

                <RELATED_NEWS_URL><![CDATA[http://해당/기사/언론사측/주소/]]></RELATED_NEWS_URL>

            </RELATED_NEWS>

        </RELATED_NEWS_LIST>

    </EXT>

</NEWS>

 

8. 기타
- 송고 후 Daum 검색 반영시간 최소 10분 소요