'api'에 해당되는 글 1건

  1. 2007/06/28 트라이블 API 서비스를 시작합니다. (23)

국가와 도시가 어디에 있을까?
내가 찾고 싶은 스팟은 어떤 곳에 있을까?
이 스팟에는 어떤 사진들이 있을까?
이 모든 정보들을 일일이 입력하기에는 손이 많이 가고,, 내 홈페이지에 쉽게 넣을 수 있는 방법이 있을까?

트라이블 API를 이용하면 트라이블내의 사진, 스팟, 국가, 도시 등의 자료를 홈페이지에서 손쉽게 사용할 수 있습니다.

트라이블 API 사용방법


트라이블 포토 검색
트라이블 포토에 업로드된 사진을 검색할 수 있습니다.

1. 요청 URL
http://apis.tryvel.com/search/photo/

2. 요청 파라미터
요청 파라미터 설명
start (integer) default : 1 리스트 시작위치
display (integer) default : 15 리스트 출력 갯수
query (string) 검색질의어 (값이 없는 경우 모든 결과값)
sort (string) default : date_desc 리스트 정렬 기준

date_desc : 최근 날짜순
date_asc : 오래된 날짜순
title_desc : 제목 내림차순
title_asc : 제목 오름차순
size_desc : 파일크기가 큰 순
size_asc : 파일크기가 작은 순
edate_desc : 최근 촬영 날짜순
edate_asc : 오래된 촬영 날짜순

요청 예시 : http://apis.tryvel.com/search/photo/start=16&display=15&query=joy&sort=edate_asc
(joy라는 단어의 검색결과를 촬영일로 정렬한 리스트의 2번째 페이지)


3. 출력 결과 필드 (RSS 포맷)
필드 설명
lastBuildDate (datetime) 검색 결과를 생성한 시간
total (integer) 검색 결과의 총 개수
start (integer) 리스트 시작위치 (요청과 동일)
display (integer) 리스트 출력 갯수 (요청과 동일)
item - 개별 리스트 (아래 item 필드 참조)

4. item 필드
필드 설명
title (string) 사진 제목
sn (integer) 사진 일련번호
link (string) 사진 원본보기 주소
thumbnail (string) 사진의 미리보기 이미지 주소
filesize (integer) 사진의 파일크기
exifDate (datetime) 사진 촬영 일시
pubDate (datetime) 사진 업로드 일시
author (string) 작성자 ID


트라이블 스팟 검색
트라이블의 스팟을 검색합니다.

1. 요청 URL
http://apis.tryvel.com/search/spot/

2. 요청 파라미터
요청 파라미터 설명
start (integer) default : 1 리스트 시작위치
display (integer) default : 15 리스트 출력 갯수
query (string) 검색질의어 (값이 없는 경우 모든 결과값)
sort (string) default : date_desc 리스트 정렬 기준

date_desc : 최근 날짜순
date_asc : 오래된 날짜순
title_desc : 제목 내림차순
title_asc : 제목 오름차순

요청 예시 : http://apis.tryvel.com/search/spot/start=1&display=15&query=st&sort=title_asc

3. 출력 결과 필드 (RSS 포맷)
필드 설명
lastBuildDate (datetime) 검색 결과를 생성한 시간
total (integer) 검색 결과의 총 개수
start (integer) 리스트 시작위치 (요청과 동일)
display (integer) 리스트 출력 갯수 (요청과 동일)
item - 개별 리스트 (아래 item 필드 참조)

4. item 필드
필드 설명
title (string) 스팟명
s_idx (integer) 스팟 일련번호
link (string) 스팟 바로가기 주소
pubDate (datetime) 스팟 등록일시
lat (integer) 스팟의 좌표 (위도)
lng (integer) 스팟의 좌표 (경도)
description (string) 스팟 상세 정보
author (string) 작성자 ID

트라이블 국가 검색
트라이블의 국가를 검색합니다.

1. 요청 URL
http://apis.tryvel.com/search/nation/

2. 요청 파라미터
요청 파라미터 설명
start (integer) default : 1 리스트 시작위치
display (integer) default : 15 리스트 출력 갯수
query (string) 검색질의어 (값이 없는 경우 모든 결과값)
sort (string) default : date_desc 리스트 정렬 기준

title_desc : 제목 내림차순
title_asc : 제목 오름차순

요청 예시 : http://apis.tryvel.com/search/nation/start=1&display=15&query=land

3. 출력 결과 필드 (RSS 포맷)
필드 설명
lastBuildDate (datetime) 검색 결과를 생성한 시간
total (integer) 검색 결과의 총 개수
start (integer) 리스트 시작위치 (요청과 동일)
display (integer) 리스트 출력 갯수 (요청과 동일)
item - 개별 리스트 (아래 item 필드 참조)

4. item 필드
필드 설명
title (string) 국가명
nationkey (integer) 국가 일련번호
link (string) 국가 바로가기 주소
lat (integer) 국가의 좌표 (위도)
lng (integer) 국가의 좌표 (경도)


트라이블 도시 검색
트라이블의 도시를 검색합니다.

1. 요청 URL
http://apis.tryvel.com/search/city/

2. 요청 파라미터
요청 파라미터 설명
start (integer) default : 1 리스트 시작위치
display (integer) default : 15 리스트 출력 갯수
query (string) 검색질의어 (값이 없는 경우 모든 결과값)
sort (string) default : date_desc 리스트 정렬 기준

title_desc : 제목 내림차순
title_asc : 제목 오름차순

요청 예시 : http://apis.tryvel.com/search/city/start=1&display=15

3. 출력 결과 필드 (RSS 포맷)
필드 설명
lastBuildDate (datetime) 검색 결과를 생성한 시간
total (integer) 검색 결과의 총 개수
start (integer) 리스트 시작위치 (요청과 동일)
display (integer) 리스트 출력 갯수 (요청과 동일)
item - 개별 리스트 (아래 item 필드 참조)

4. item 필드
필드 설명
title (string) 도시명
citykey (integer) 도시 일련번호
link (string) 도시 바로가기 주소
lat (integer) 도시의 좌표 (위도)
lng (integer) 도시의 좌표 (경도)

2007/06/28 14:06 2007/06/28 14:06