OpenAPI - Data

78719 OpenAPI - Data 269153 2007-11-24T03:50:54Z http://lifepod.springnote.com/pages/78719 2007-04-05T23:18:38Z <h1>라이프팟 OpenAPI - Data 문서<a href="/pages/78719#toc_0" class="anchor" title="toc_0" id="toc_0" >#</a></h1> <a href="http://www.lifepod.co.kr/">http://www.lifepod.co.kr/</a>   <div id="toc" style="background-color: rgb(255, 255, 250); border-top-width: 1px; border-right-width: 1px; border-bottom-width: 1px; border-left-width: 1px; border-top-style: solid; border-right-style: solid; border-bottom-style: solid; border-left-style: solid; border-top-color: rgb(210, 180, 140); border-right-color: rgb(210, 180, 140); border-bottom-color: rgb(210, 180, 140); border-left-color: rgb(210, 180, 140); padding-top: 2px; padding-right: 10px; padding-bottom: 0px; padding-left: 10px;"> 목차 <hr /> <ol> <li> <a href="/pages/78719#toc_0" class="external" title="toc_0">라이프팟 OpenAPI - Data 문서</a> <ol> <li><a href="/pages/78719#toc_1" class="external" title="toc_1">1. 개요</a></li> <li><a href="/pages/78719#toc_2" class="external" title="toc_2">2. 기본 사항</a></li> <li> <a href="/pages/78719#toc_3" class="external" title="toc_3"> 3. XML 형식</a> <ol> <li><a href="/pages/78719#toc_4" class="external" title="toc_4">3-1. 캘린더의 정보</a></li> <li><a href="/pages/78719#toc_5" class="external" title="toc_5">3-2. OpenSearch 정보</a></li> <li><a href="/pages/78719#toc_6" class="external" title="toc_6">3-3. 일정 정보</a></li> <li><a href="/pages/78719#toc_7" class="external" title="toc_7">4. 기타</a></li> </ol> </li> </ol> </li> </ol> </div>     <h2>1. 개요<a href="/pages/78719#toc_1" class="anchor" title="toc_1" id="toc_1" >#</a></h2> <ul> <li>라이프팟 Data OpenAPI는 캘린더(일정의 분류) 단위로 XML포맷으로 이용하실 수 있습니다.</li> <li>라이프팟 Data OpenAPI는 별도의 인증이 필요하지 않습니다.</li> <li>제한된 데이터(개인 정보)에 대한 접근은 캘린더마다 할당된 키(암호와 비슷한 일련의 문자열)를 통해서만 할 수 있습니다.</li> <li>공개되지 않은 캘린더의 키는 절대 공개되어서는 안됩니다. 모든 데이터에 접근할 수 있게 되므로 개인정보 유출의 위험이 있습니다.</li> </ul>   <h2>2. 기본 사항<a href="/pages/78719#toc_2" class="anchor" title="toc_2" id="toc_2" >#</a></h2> <ul> <li>라이프팟의 OpenAPI는 HTTP 1.1의 GET method를 이용하여 요청하고 XML문서를 응답받습니다.</li> <li> 데이터에 접근하기 위한 URL <ul> <li>http://www.lifepod.co.kr/calendar/feed/{개인캘린더ID}.xml</li> <li>예-한국의 기념일: http://www.lifepod.co.kr/calendar/feed/1.xml</li> </ul> </li> <li>정렬은 날짜로 내림차순 정렬 됩니다.</li> <li> 기본적으로 50개씩 표시됩니다. 1부터 시작하는 page라는 파라메터를 통해 다음 데이터를 가져올 수 있습니다. <ul> <li> 예: 2페이지 보기 <ul> <li>http://www.lifepod.co.kr/calendar/feed/{개인캘린더ID}.xml?page=2   </li> </ul> </li> <li> 예: 10페이지 보기 <ul> <li>http://www.lifepod.co.kr/calendar/feed/{개인캘린더ID}.xml?page=10</li> </ul> </li> </ul> </li> <li> 기본적으로 표시되는 데이터는 이번달의 데이터 입니다. start, end 파라메터를 통해 이 기간을 조정할 수 있습니다. <ul> <li> 예: 2007년 1월부터 <ul> <li>http://www.lifepod.co.kr/calendar/feed/{개인캘린더ID}.xml?start=2007-01-01</li> </ul> </li> <li> 예: 2007년 1월부터 2007년 3월까지 <ul> <li>http://www.lifepod.co.kr/calendar/feed/{개인캘린더ID}.xml?start=2007-01-01&end=2007-03-01</li> </ul> </li> </ul> </li> <li>위의 page, start, end 파라메터들을 조합해서 쓸 수 있습니다.</li> <li> 위의 세가지 파라메터 외에 공개되지 않은 캘린더(비공개, 선택된 이웃그룹에게 공개, 이웃에게 공개)의 경우 key라는 파라메터가 추가됩니다. <ul> <li>http://www.lifepod.co.kr/calendar/feed/{개인캘린더ID}.xml?key=xxxxxxxxxxxxxxxxxxxxxxxxxxxxx</li> <li>이 키는 절대 공개되어서는 안됩니다.</li> </ul> </li> </ul>   <h2> 3. XML 형식<a href="/pages/78719#toc_3" class="anchor" title="toc_3" id="toc_3" >#</a></h2> <ul> <li>참고 URL: http://www.lifepod.co.kr/calendar/feed/1.xml</li> <li>XML문서에는 크게 캘린더의 정보와 OpenSearch의 정보, 일정의 정보가 포함되어 있습니다.</li> </ul>   <h3 style="margin-left: 2em;">3-1. 캘린더의 정보<a href="/pages/78719#toc_4" class="anchor" title="toc_4" id="toc_4" >#</a></h3> <ul style="margin-left: 2em;"> <li>id: XML문서의 ID로 키를 포함한 XML문서 자체의 전체 URL을 의미함</li> <li>title: 캘린더의 제목</li> <li>subtitle: 캘린더에 대한 설명</li> <li>generator: 이 문서의 생성기(Lifepod)</li> </ul>   <h3 style="margin-left: 2em;">3-2. OpenSearch 정보<a href="/pages/78719#toc_5" class="anchor" title="toc_5" id="toc_5" >#</a></h3> <ul style="margin-left: 2em;"> <li>openSearch:totalResult: 전체 일정 데이터의 갯수</li> <li>openSearch:startIndex: 1부터 시작하는 현재 일정 데이터가 시작하는 지점</li> <li>openSearch:itemsPerPage: 한번에 표시될 일정 데이터의 갯수(50개)</li> </ul>   <h3 style="margin-left: 2em;">3-3. 일정 정보<a href="/pages/78719#toc_6" class="anchor" title="toc_6" id="toc_6" >#</a></h3> <ul style="margin-left: 2em;"> <li>identifier: 일정 데이터의 ID</li> <li>date-modified: 갱신된 시간(UTC 기준)</li> <li>date-start: 일정의 시작 시간(UTC 기준)</li> <li>date-end: 일정의 끝 시간(UTC 기준)</li> <li>title: 제목</li> <li>description: 내용</li> <li> type: 일정의 종류 <ul> <li>schedule: 일반 일정</li> <li>daylong: 종일 일정</li> <li>anniversary: 기념일</li> <li>RSS: RSS 항목</li> <li>special: 특수한 일정</li> </ul> </li> <li>uuid: 이전에 싱크된 데이터의 경우 표시되는 UUID</li> </ul>   <h3>4. 기타<a href="/pages/78719#toc_7" class="anchor" title="toc_7" id="toc_7" >#</a></h3> <ul> <li>쉽게 XML 문서의 링크를 얻는 방법과 키를 변경하는 방법은 아래 그림을 참고하세요.</li> <li>키를 변경할 경우 ICAL(.ics 파일), iCal 발행, HTML 등의 키도 모두 변경됩니다.</li> <li><img class="attachment" title="xml.png" src="/pages/78719/attachments/271067" alt="xml.png" /></li> </ul> http://lifepod.myid.net/ http://lifepod.myid.net/ 857