레뷰 OpenAPI를 소개 합니다.

RevU 개선소식 2008/04/01 18:39
사용자 삽입 이미지






안녕하세요. 세상 모든 것에 대한 리뷰 - 레뷰입니다.
레뷰에서는 외부에서도 레뷰의 모든 검색 서비스를 자유롭게 이용할 수 있도록 API를 공개합니다.

레뷰의 OpenAPI는 http://www.revu.co.kr/OpenAPI 에서 보실수 있으며
OpenAPI를 사용하기 위해서는 인증키를 꼭 발급받으셔야 합니다.

레뷰의 OpenAPI와 타 서비스의 OpenAPI를 이용해서 더욱 다양한 매쉬업 서비스가 가능할것으로 보여집니다.
개발자 여러분들의 많은 관심 부탁드리며, 레뷰 OpenAPI에 대해 궁금하신 사항은 댓글로 달아주시거나
메일 (revu@revu.co.kr)로 주세요.


자세한 내용은 아래 사용방법을 참고하시기 바랍니다.



* 사용방법
1. 레뷰 OpenAPI 는 http://api.revu.co.kr:81 에서 서비스되고 있습니다.
2. 모든 호출에 대하여 HTTP 1.1 에 따른 GET, POST 방식을 지원합니다.
3. http://www.revu.co.kr/OpenAPI 에서 발급받은 인증키를 반드시 지정해야 합니다.
(한번 발급받은 인증키는 http://www.revu.co.kr/OpenAPI 에서 다시 확인할 수 있습니다)
4. 모든 요청에 대하여 항상 대소문자를 구분(Case sensitive)합니다.
5. 요청의 처리 결과는 REST 형태의 UTF-8 encoded XML 을 반환합니다.

* 기능의 사용
각 기능의 호출은 Namespace 방식의 요청으로 처리됩니다.

예)
http://api.revu.co.kr:81/RevUAPI::Review::Search?AuthToken=인증키&Keyword=레뷰
http://api.revu.co.kr:81/RevUAPI::Item::Detail?AuthToken=인증키&ID=75A6664A-804A-4526-96C9-80666EE36856

위의 예제에서 볼 수 있듯, RevUAPI 는 Global namespace 로서 반드시 지정되어야 합니다(인증키는 http://www.revu.co.kr/OpenAPI 에서 발급받은 인증키를 입력해야합니다).
RevUAPI 의 하위 Namespace 는 서비스를 정의하며 보조 서비스 Namespace 가 존재할 수 있습니다.
최하위에는 사용할 기능을 정의하게 됩니다.

* Namespace 및 기능 목록
Global namespace
RevUAPI

Service namespace
Review
Item
Collection
Image

Function
Review
- Search(+) : 리뷰 검색
Item
- Search(*) : 아이템 검색
- Detail : 아이템 정보
- Review : 아이템 간단평가
Collection
- Search(*) : 컬렉션 검색
- Detail : 컬렉션 정보

서비스 중 Image 의 경우, 보조 서비스 Namespace 를 갖고 있습니다.

Sub-service namespace
Review
Item
Collection

Function
Draw(+) : 이미지 표시

(* : 현재 준비중인 서비스, + : 기본값)

* 요청 결과
레뷰 OpenAPI 는 REST(Representational state transfer) 형태의 결과를 리턴합니다(Image API 의 경우는 이미지 바이너리 데이터를 반환합니다).

성공일 경우
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="ok">
  [xml-payload-here]
</rsp>

실패일 경우
<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
  <err code="[error-code]" msg="[error-message]" />
</rsp>

예) 아이템의 ID가 "75A6664A-804A-4526-96C9-80666EE36856" 인 아이템의 정보를 가져오는 경우(인증키는 http://www.revu.co.kr/OpenAPI 에서 발급받은 인증키를 입력해야합니다)

http://api.revu.co.kr:81/RevUAPI::Item::Detail?AuthToken=인증키&ID=75A6664A-804A-4526-96C9-80666EE36856 의 호출결과

<?xml version="1.0" encoding="UTF-8" ?>
<rsp version="1.3" stat="ok">
 <Item Category="서비스 > 웹/인터넷" Name="레뷰" RankScore="9.7" Have="12" Wish="1" Create="revu" CreateDate="2007-05-07 15:47:33.623">
  <CategoryLink>
   <![CDATA[ <a href="http://www.revu.co.kr/Taxonomy/4D5B244F-4750-496F-B688-416C564C7921">서비스</a> > <a href="http://www.revu.co.kr/Taxonomy/F477D1B3-47AB-47D1-BB8F-187FE29CBDE6">웹/인터넷</a>]]>
  </CategoryLink>
  <Permalink>
   <![CDATA[ http://www.revu.co.kr/Item/75A6664A-804A-4526-96C9-80666EE36856 ]]>
  </Permalink>
  <Image>
   <![CDATA[ http://www.revu.co.kr/ImageViewItem.aspx?ID=75A6664A-804A-4526-96C9-80666EE36856&Width=$WIDTH$&Height=$HEIGHT$ ]]>
  </Image>
  <Description Update="revu" UpdateDate="2008-01-16 11:31:17.513">
   <![CDATA[ 세상 모든 것의 리뷰가 있는 곳 [http://www.revu.co.kr 레뷰]<br><br>[http://blog.revu.co.kr 공식블로그]]]>
  </Description>
 </Item>
</rsp>

반환된 XML 의 노드에 대한 설명은 각 기능별 설명 페이지에서 확인하실 수 있습니다.

'RevU 개선소식' 카테고리의 다른 글

이제 펜션 정보도 레뷰에서 나눠보세요!  (1) 2008/04/18
회원리뷰 보기가 확 바뀌었어요~  (0) 2008/04/07
레뷰 OpenAPI를 소개 합니다.  (2) 2008/04/01
최근 바뀐 레뷰 서비스 몇 가지  (2) 2008/03/25
레뷰 카테고리가 개편 되었습니다.  (0) 2008/03/25
오픈아이디 공동 이벤트에 참여하며  (23) 2008/02/13
Posted by 비회원
TAG , ,
트랙백 0개, 댓글 2개가 달렸습니다

댓글을 달아 주세요

  1. 2010/06/21 20:34  댓글주소  수정/삭제  댓글쓰기

    비밀댓글입니다