codian님의 노트

데스크톱 어플리케이션 방식

Thu, 21 Aug 2008 10:51:11 +0900

인증 안내

데스크톱 어플리케이션이 사용하는 '웹 기반 쉬운 인증'의 경우 최종 인증 과정이 완료되면 '인증 토큰'이란 것을 발급 받게 됩니다. 이는 기존에 미투데이 API가 사용하던 API Key 없이도 사용자 인증을 할 수 있도록 구성된 방식입니다. 인증토큰을 이용해 미투데이 API 사용시 사용자를 인증하는 방법은, 기존의 인증방식과 모두 동일하데(HTTP Basic 방식 사용) 아이디와 암호를 아래와 같이 사용하시면 됩니다.

ID : 미투데이 사용자 아이디

Pass : full_auth_token [발급받은 인증 토큰]

full_auth_token이 앞에 인식자로 붙고, 뒤에 반드시 하나의 공백이 있어야 하는 점을 주의해 주시면 됩니다. 나머지는 모두 동일합니다.

인증 흐름

S) : API 사용 서비스 (예: Revu ... )

U) : 사용자

M) : me2DAY

S) -> M) : me2day.net/api/get_auth_url ( APP_KEY 필수. HTTP Header에 APP KEY를 실어 보내셔야 합니다 )

M) -> S) : token, auth url 리턴 *token : token 은 me2DAY에 의해 임의로 생성된 인증용 키(Key)입니다.

S) -> U) : auth_url로 웹 브라우저 호출 및 사용자에게 인증과정 완료후 다음 액션을 취하라는 안내 표시

U) -> M) : me2DAY 로그인

U) -> M) : Application 의 API Access 수락/거부

M) -> U) : Application 의 안내를 따르라는 안내 페이지로 사용자 이동

S) -> U) : 사용자에게 인증 완료 컨펌을 받음

S) -> M) : me2day.net/api/get_full_auth_token?token= ( APP_KEY 필수, token은 위 2단계에서 발급받은 token 입니다 )
M) -> S) : 인증 토큰 발급

데스크톱 어플리케이션 인증 방식을 사용하고자 하시는 경우 codian@me2day.net 이나 kkung@me2day.net 으로 연락 주시면 처리해 드립니다.
인증 토큰의 유효성 관리 차원으로 get_full_auth_token 으로 특정 token에 대해서 인증을 구하면, 그 이후로 해당 token에 대해서는 인증 토큰을 구할 수 없도록 만료 시켜 버립니다. 따라서 다시 인증 절차를 밟고자 하시면 get_auth_url로 token부터 다시 구해서 진행해야 합니다.

인증 예제

get_auth_url 리턴

<auth_token>
   <url>
      http://localhost:3000/api/auth?token=4eb43fd44c953f0c83504c4c1daf493d
   </url>
   <token>4eb43fd44c953f0c83504c4c1daf493d</token>
</auth_token>

사용자를 위의 url로 이동시킴

사용자가 수락 혹은 거부 했을 경우

get_full_auth_token 으로 최종 인증 토큰을 구해왔을때 결과값 예시

<auth_token>
<user_id>kkung</user_id>
<full_auth_token>dcd4b7340435d26e9d4c3d9725f7ef33</full_auth_token>
</auth_token>

me2API 사용설명서

Wed, 20 Aug 2008 14:28:37 +0900

요청과 응답

me2API의 요청은 HTTP 요청방식을 사용합니다. GET 또는 POST 메소드를 모두 사용할 수 있습니다.
미투데이 서버로 파라미터를 전달하는 경우 파라미터는 HTML 폼의 기본 인코딩 방식인 application/x-www-form-urlencoded를 사용해 인코딩합니다. 이때 문자열의 인코딩은 UTF-8을 따릅니다. 다만 파일을 업로드하는 경우에는 multipart/form-data 로 인코딩합니다.

me2API 의 응답은 현재 XML 형식과 JSON 형식을 지원하고 있습니다. 요청시 응답형식을 지정해 선호하는 형식을 사용할 수 있습니다. 응답 형식을 지정하지 않는 경우 XML 형식이 지정됩니다. XML 형식의 응답인 경우 XML 인코딩은 UTF-8을 따릅니다.

JSON 형식 호출시 callback 파라미터를 지정하는 경우 지정한 콜백함수을 호출하는 형식으로 결과가 반환됩니다. 즉 다음과 같은 URL로 요청을 한 경우,

http://me2day.net/api/get_friends/rath.json?callback=my_func

응답 형식은 다음과 같습니다.

my_func(<JSON 형식의 API 처리 결과>);

에러 응답

me2API 요청시 에러가 발생한 발생한 경우 HTTP 상태코드와 응답 본문을 통해 에러를 확인할 수 있습니다.

HTTP 상태코드

me2API 요청시 발생할 수 있는 HTTP 상태코드는 다음과 같습니다.

401 Unauthenticated: 인증되지 못한 경우입니다.
403 Forbidden: 제공하지 않는 데이터입니다.
500 Internal Server Error: 요청처리시 발생한 오류입니다.
301 Moved Permanently: me2API 요청 URL이 변경되었음을 나타냅니다.
200 OK: 정상적으로 처리된 경우입니다.

주의) 파이어폭스 3.0.X에서 JSON callback 요청시 무조건 상태코드 200을 반환합니다.

응답 본문

응답의 HTTP 상태코드가 500 Internal Server Error 인 경우 발생한 에러의 상세내용을 다음과 같은 형식으로 받아 볼 수 있습니다. 다음 XML형식으로 요청한 경우의 예이며 JSON 형식으로 요청한 경우 같은 내용이 JSON 형식으로 반환됩니다.

<error>
<code>1004</code>
<message>파라미터가 올바르지 않습니다.</message>
<description>지정한 사용자를 찾을 수 없습니다.</description>
</error>

만약 요청이 정상적으로 처리된 경우 응답 본문은 메소드에 따릅니다.

어플리케이션 키

어플리케이션 키는 me2API 를 사용한 어플리케이션을 구분하는 키입니다. me2API를 사용해 어플리케이션을 만드는 경우 미투데이로 부터 어플리케이션 키를 발급 받아 사용해야 합니다. 발급 받은 어플리케이션 키는 모든 me2API 요청시 요청 헤더, 'me2_application_key'에 지정하거나 query string 또는 post body에 인자(파라미터명은 akey)로 지정합니다. 이렇게 지정된 어플리케이션 키는 어플리케이션의 사용량 점검등을 위해 사용됩니다.

다음은 query string 으로 어플리케이션키를 지정해 get_posts 메소드를 호출하는 예입니다.

http://me2day.net/api/get_posts/codian?akey=XXXXXXXXXXXXXXXX

어플리케이션 키는 발급 받으시려는 분은 어플리케이션키 발급 요청 페이지에서 신청하세요 (로그인하셔야 합니다.)

me2API 사용자 인증

me2API에서 제공하는 일부 메소드는 사용자 인증이 필요합니다. 사용자 인증은 HTTP Basic Authentication 방식을 사용하거나 query string 또는 post body에 파라미터로 사용자 인증 정보를 지정할 수 있습니다.

요청 파라미터로 지정하는 방식의 사용자 인증은 사용자와 인증키를 query string 또는 post body 의 파라미터로 지정해 인증하는 방식입니다. 파라미터 uid 에 미투데이 이름을 지정하고 파라미터 ukey 에 인증키를 지정하여 요청을 보내면 인증을 시도합니다.

인증키는 8자리 nonce 문자열과 사용자 키를 붙인 후 md5로 인코딩하고 앞에 다시 nonce 문자열을 붙여 만들어진 문자열입니다.
여기서 nonce는 me2API 어플리케이션 측에서 임의로 생성된 8자리 16진수 문자열입니다.

인증키 => nonce + md5(nonce + user_key)

me2API 사용자키(user_key)는 미투데이 관리페이지를 통해 확인하거나 다시 생성할 수 있습니다. me2API 사용자키는 me2API를 사용하기 위해 각 사용자에게 발급된 키로 사용자 인증을 위해 사용됩니다. 발급된 사용자키는 미투데이 관리페이지에서 확인할 수 있고 재발급 받을 수도 있습니다.

다음은 query string 에 사용자 정보를 지정하 예입니다.

http://me2day.net/api/noop?uid=codian&ukey=XXXXXXXXXXXXXXXX&akey=XXXXXXXXXXXXXXXX

HTTP Basic Authentication 방식의 사용자 인증은 사용자와 인증키를 다음과 같이 지정합니다.

username => 미투데이 이름. 예) codian

password => 인증키

username 필드는 미투데이에 가입시 등록하여 미투데이 페이지의 URL에 사용하고 있는 미투데이 이름을 지정합니다. password 필드는 me2API 사용자키로 생성한 인증키를 지정합니다. 인증키 생성은 요청 파라미터로 지정하는 방식과 동일합니다.

만약, 웹 기반 쉬운 인증을 사용하시면서 이중 데스크톱 기반 인증 방식을 사용하시고자 하시는 경우, API Key없이 인증할수 있는 방법을 제공하고 있습니다. me2API 웹 기반 쉬운 인증> 데스크톱 어플리케이션 방식 페이지를 참고하시기 바랍니다.

me2API 메소드

create_post : 지정한 회원의 미투데이 페이지에 글을 작성합니다.
get_latests : 지정한 회원의 최근글을 가져옵니다.
get_posts: 지정한 회원의 글을 가져옵니다.
create_comment : 지정한 글에 댓글을 작성합니다.
delete_comment: 지정한 댓글을 삭제합니다.
get_comments : 지정한 글의 댓글을 가져옵니다.
track_comments: 회원이 최근 작성한, 회원의 미투페이지에 최근 작성된 댓글을 가져옵니다.
get_person : 지정한 회원 정보를 가져옵니다.
get_friends : 지정한 회원의 친구목록을 가져옵니다.
get_settings : 개인 설정 사항을 가져옵니다.
get_tags: 태그와 태그를 포함하는 글 수를 가져옵니다.
noop : 사용자인증 테스트를 하거나 서버 동작상태를 검사합니다.

me2API 웹 기반 쉬운 인증

Wed, 20 Aug 2008 14:26:58 +0900

들어가며

미투데이 회원들이 즐겨서 이용했던 미투테트리스, 미투러브, 미투지뢰찾기, 미투프리셀 등 다양한 게임들. 또한 미친들에게 많은 토큰과 경품 선물을 해준 레뷰2미투 기능. 이런 외부 서비스에서 미투데이로 글을 올리거나 친구 정보를 가져올 수 있는 건 me2API가 있기 때문입니다.

문제는 여기서 시작합니다. 많은 미친들이 좋아할만한 서비스를 만들었는데 처음 시작하려면 me2API 사용자키를 외워서 입력해야 한다는 거. 처음에 이게 뭔지 몰라서 정작 해당 서비스를 이용하지 못하는 경우들이 많이 있었죠. 이걸 좀더 편리하게 클릭만으로 할 수 있는 방법은 없는걸까요?

me2API 웹기반 쉬운 인증이란

me2API 웹기반 쉬운 인증은, 기존에 사용자가 외부에서 me2DAY API를 이용하고자 할 때 익숙치 않은 API User Key를 입력해야 했던 불편을 개선하고, 나아가 좀 더 사용자 친화적인 사용환경이 될 수 있도록 고안된 방식 입니다. 이 방식을 통해 사용자는 더이상 API Key를 인지하고 있지 않아도 되며 웹 브라우저상에서 손쉽게 API사용 인증을 획득할 수 있습니다.

웹 기반 쉬운 인증이 제공하고 있는 방식

웹 기반 쉬운 인증은 다음과 같은 종류의 방식을 제공하고 있으며, 어플리케이션 특성에 맞게 적절히 선택하여 활용하시면 됩니다.

웹 어플리케이션 방식

Wed, 20 Aug 2008 14:07:16 +0900

인증 흐름

S) : API 사용 서비스 (예: Revu ... )

U) : 사용자

M) : me2DAY

S) -> M) : me2day.net/api/get_auth_url ( APP_KEY 필수. HTTP Header에 APP KEY를 실어 보내셔야 합니다 )

M) -> S) : token, auth url 리턴 *token : token 은 me2DAY에 의해 임으로 생성된 인증용 키(Key)입니다.

S) -> U) : auth_url로 redirect

U) -> M) : me2DAY 로그인

U) -> M) : Application 의 API Access 수락/거부

M) -> S) : 미리 저장된 callback url로 인증 결과 회신

*callback params

token : get_auth_url 시 생성된 인증용 키

user_id : 인증한 사용자의 미투데이 아이디

user_key : 인증한 사용자의 API Key ( result false 시 null )

result : 인증 결과

* callback_url은 codian@me2day.net 혹은 kkung@me2day.net 으로 Application Key를 포함하셔서 메일 주시면 처리해 드립니다.

인증 화면 예제

get_auth_url 리턴 예제

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

<auth_token>

<url>http://localhost:3000/api/auth?token=77d2d5c3451d2b11c2c583b05e5a898b</url>

<token>77d2d5c3451d2b11c2c583b05e5a898b</token>

</auth_token>

url 로 redirect 했을때의 로그인 화면 (로그인 되있다면 통과)

응용프로그램 인증 여부 선택 화면

get_person

Thu, 14 Aug 2008 17:30:31 +0900

get_person

미투데이 가입자 정보를 가져옵니다.

사용자 인증은 필요없습니다.

URL

http://me2day.net/api/get_person/[미투데이아이디].[응답형식]

응답형식은 xml, json 중 하나를 지정합니다. 지정하지 않은 경우 xml을 응답형식으로 사용합니다.

예) http://me2day.net/api/get_person/codian.json

파라미터

없음

응답

가입자 정보

xml 형식

<person>
    <id>codian</id>
    <openid>http://codian.net/</openid>
    <nickname>코디안</nickname>
    <face>http://me2day.net/images/user/codian/한글이름.jpg</face>
<description>내일 뛰지 않으려면 오늘 가야지!</description>
<homepage>http://codian.net</homepage>
<email>codian@gmail.com</email> // 공개한 경우만 접근할 수 있습니다.
<cellphone>xxxxxxxxxx</cellphone> // 공개한 경우만 접근할 수 있습니다.
<messenger>xxxxxxxxxx</messenger> // 공개한 경우만 접근할 수 있습니다.
    <rssDaily>http://me2day.net/codian/rss_daily</rssDaily>
    <invitedBy>sumanpark</invitedBy>
    <friendsCount>346</friendsCount>
    <updated>2007-04-19T14:43:15Z</updated>
<postIcons>
<postIcon>
<iconIndex>1</iconIndex>
<iconType>1</iconType>
<url>http://me2day.net/images/skins/skin3/post_think.gif</url>
<description/>
<default>true</default>
</postIcon>
<postIcon>
<iconIndex>2</iconIndex>
<iconType>2</iconType>
<url>http://me2day.net/images/skins/skin3/post_feel.gif</url>
<description/>
<default>false</default>
</postIcon>
</postIcons>
<flickr>
<nsid>28297366@N00</nsid>
</flickr>
</person>

json 형식

{
        "id": "codian",
        "openid": "http://codian.net/",
        "nickname": "\ucf54\ub514\uc548",
        "face": "http://me2day/images/user/codian/\ud55c\uae00\uc774\ub984.jpg",
        "description": "\ub0b4\uc77c \ub6f0\uc9c0 \uc54a\uc73c\ub824\uba74 \uc624\ub298 \uac00\uc57c\uc9c0!",
"homepage": "http://codian.net",
"email": "codian@me2day.net", // 공개한 경우만 접근할 수 있습니다.
"cellphone": "xxxxxxxxxx", // 공개한 경우만 접근할 수 있습니다.
"messenger": "xxxxxxxxxx", // 공개한 경우만 접근할 수 있습니다.
        "rssDaily": "http://me2day.net/codian/rss_daily",
        "invitedBy": "sumanpark",
        "friendsCount": 346,
        "updated": "2007-04-19T14:43:15Z",
"postIcons": [

{

"iconIndex":1,

"iconType":1,

"url":"http:\/\/me2day.net\/images\/skins\/skin3\/post_think.gif",

"description":"",

   "default":true

},{

  "iconIndex":2,

"iconType":2,

"url":"http:\/\/me2day.net\/images\/skins\/skin3\/post_feel.gif",

  "description":"",

   "default":false
}
],

   "flickr": {

   "nsid": "28297366@N00"

   }

}

updated 속성은 최종 글 작성일을 나타냅니다.

get_posts

Thu, 07 Aug 2008 20:48:33 +0900

get_posts

지정한 미투데이 사용자의 글 목록을 가져옵니다.

사용자 인증은 필요없습니다.

URL

http://me2day.net/api/get_posts/[미투데이아이디].[응답형식]

응답형식은 xml, json, rss 중 하나를 지정합니다. 지정하지 않은 경우 xml을 응답형식으로 사용합니다.

예) http://me2day.net/api/get_posts/codian.xml

파라미터

from, to : 작성일자 기준으로 from 과 to 파라미터가 지정한 기간의 글을 가져옵니다. from 과 to 파라미터에 지정할 시각을 나타내는 문자열의 형식은 ISO 8601 형식을 따릅니다. 파라미터를 지정하지 않은 경우 from 은 현재시각, to는 24시간 이전으로 지정됩니다. 또, from만 지정한 경우 from + 24시간으로 지정됩니다.
tag : 파라미터를 지정한 경우, 지정한 태그가 입력된 글들만 검색 합니다.

응답

글 목록.

주의할 점은 pubDate 시각의 시간대는 utc 입니다.

xml 형식

<?xml version="1.0" encoding="UTF-8"?>
<posts>
<post>
<post_id>p9g_6</post_id>
<permalink>http://me2day.net/kkung/2007/08/02#21:51:06</permalink>
<body>실버라잇 세미나를 빙자한 미투 부흥회중</body>
<kind>think</kind>
    <icon>http://me2day.net/images/post_think.gif</icon>
    <tags>
      <tag>
        <name>미투부흥회</name>
<url>http://me2day.net/kkung/tag/미투부흥회</url>
</tag>
</tags>
<me2dayPage>http://me2day.net/kkung</me2dayPage>
<pubDate>2007-08-02T12:51:06+0900</pubDate>
<commentsCount>10</commentsCount>
<metooCount>1</metooCount>
<contentType>me2photo</contentType>
<callbackUrl>http://me2day.net/front/me2photo?id=2638622048&post_id=pmfps</callback_url>
<iconUrl>http://farm4.static.flickr.com/3128/2638622048_1a20903072_s.jpg?200807070534</icon_url>
    <author>
      <id>kkung</id>
      <nickname>kkung</nickname>
<face>http://me2day.net/images/profile.png</face>
<homepage>http://www.kkung.net</homepage>
<me2dayHome>http://m/kkung</me2dayHome>
</author>
<location>
<name>Seoul</name>
<longitude/>
<latitude/>
</location>
<media>
  <me2photo>
  <provider>flickr</provider>
  <photoId>2138021550</photoId>
<photoUrl>
http://farm3.static.flickr.com/2204/2138021550_4b8257d416.jpg
  </photoUrl>
   <permalink>http://www.flickr.com/photos/me2flickr/2138021550/</permalink>
   </me2photo>
</media>
</post>
</posts>

json 형식

[
{
"post_id":"p9g_6",
"me2dayPage": "http://me2day.net/kkung",
"permalink": "http:\/\/localhost:3000\/kkung\/2007\/08\/02#21:51:06",
"commentsCount": 10,
"kind": "think",
"body": "\uc2e4\ubc84\ub77c\uc787 \uc138\ubbf8\ub098\ub97c \ube59\uc790\ud55c \ubbf8\ud22c \ubd80\ud765\ud68c\uc911",
"icon": "http://me2day.net\/images\/post_think.gif",
"metooCount": 1,
"contentType": "me2photo",
"callbackUrl": "http://me2day.net/front/me2photo?id=2638622048&post_id=pmfps",
"iconUrl": "http://farm4.static.flickr.com/3128/2638622048_1a20903072_s.jpg?200807070534",
"author": {
"face": "http:\/\/localhost:3000\/images\/profile.png",
"me2dayHome": "http:\/\/localhost:3000\/kkung",
"nickname": "kkung",
"homepage": "http:\/\/www.kkung.net",
"id": "kkung"
},
location:{
name: "Seoul",
longitude: null,
latitude: null
},

"tags": [
{
"url": "http://me2day.net\/kkung\/tag\/\ubbf8\ud22c\ubd80\ud765\ud68c",
"name": "\ubbf8\ud22c\ubd80\ud765\ud68c"
}
],
"pubDate": "2007-08-02T12:51:06+0900",
"media":{
"provider":"flickr",

"photoId":"2138021550",

"photoUrl":"http://farm3.static.flickr.com/2204/2138021550_4b8257d416.jpg",

"permalink":"http://www.flickr.com/photos/me2flickr/2138021550/"

}
}
]

rss 형식

rss 2.0 형식을 사용합니다.

get_latests

Thu, 07 Aug 2008 20:19:50 +0900

get_latests

지정한 미투데이 사용자의 최근글 목록을 가져옵니다.

사용자 인증은 필요없습니다.

URL

http://me2day.net/api/get_latests/[미투데이아이디].[응답형식]

응답형식은 xml, json, rss 중 하나를 지정합니다. 지정하지 않은 경우 xml을 응답형식으로 사용합니다.

예) http://me2day.net/api/get_latests/codian.xml

파라미터

없음

응답

글 목록

xml 형식

<?xml version="1.0" encoding="UTF-8"?>
<posts>
<post>
<post_id>p9h0r</post_id>
    <permalink>http://me2day.net/me2daytest/2007/04/22#01:17:16</permalink>
    <body><a href="http://me2day.net">미투데이</a>에 글을 올립니다.</body>
    <kind>think</kind>
    <icon>http://me2day.net/images/post_think.gif</icon>
    <tags>
   <tag>
   <name>me2api</name>
        <url>http://localhost:3000/me2daytest/tag/me2api</url>
     </tag>
   <tag>
   <name>create_post</name>
       <url>http://localhost:3000/me2daytest/tag/create_post</url>
     </tag>
     <tag>
   <name>글쓰기</name>
       <url>http://localhost:3000/me2daytest/tag/글쓰기</url>
     </tag>
   </tags>
    <me2dayPage>http://me2day.net/me2daytest</me2dayPage>
    <pubDate>2007-04-22T01:17:16+0900</pubDate>
    <commentsCount>0</commentsCount>
<metooCount>0</metooCount>
<contentType>me2photo</contentType>
<callbackUrl>
http://me2day.net/front/me2photo?id=2638622048&post_id=pmfps
</callback_url>
<iconUrl>
http://farm4.static.flickr.com/3128/2638622048_1a20903072_s.jpg?200807070534
</icon_url>
<author>
   <id>me2daytest</id>
      <nickname>미투데이</nickname>
      <face>http://me2day.net/images/user/codian/한글이름.jpg</face>
      <homepage>http://me2day.net</homepage>
      <me2dayHome>http://me2day.net/me2daytest</me2dayHome>
    </author>
<location>
<name>Seoul</name>
<longitude/>
<latitude/>
</location>
  <media>
<me2photo>
<provider>flickr</provider>
  <photoId>2138021550</photoId>
  <photoUrl>
http://farm3.static.flickr.com/2204/2138021550_4b8257d416.jpg
</photoUrl>
   <permalink>
http://www.flickr.com/photos/me2flickr/2138021550/
</permalink>
</me2photo>
</media>
</post>
</posts>

json 형식

[
{
"post_id":"p9h0r",
permalink: "http://me2day.net/me2daytest/2007/04/22#01:15:22",
            body: "\"\ubbf8\ud22c\ub370\uc774\":http://me2day.net \uc5d0 \uae00\uc744 \uc62c\ub9bd\ub2c8\ub2e4.",
            kind: "think",
            icon: "http://me2day.net/images/post_think.gif",
            tags: [
                    {
                    name: "me2api",
                    url: "http://localhost:3000/me2daytest/tag/me2api"
                }, {
                    name: "create_post",
                    url: "http://localhost:3000/me2daytest/tag/create_post"
                }, {
                    name: "\uae00\uc4f0\uae30",
                    url: "http://localhost:3000/me2daytest/tag/\uae00\uc4f0\uae30"
                }
            ],
            me2dayPage: "http://me2day.net/me2daytest",
            pubDate: "2007-04-21T16:15:22+0900",
            commentsCount: 0,
metooCount: 0,
contentType: "me2photo",
callbackUrl: "http://me2day.net/front/me2photo?id=2638622048&post_id=pmfps",
iconUrl: "http://farm4.static.flickr.com/3128/2638622048_1a20903072_s.jpg?200807070534",
author: {
                    id: "me2daytest",
                    nickname: "\ubbf8\ud22c\ub370\uc774",
                    face: "http://me2day.net/images/user/codian/한글이름.jpg",
                    homepage: "http://me2day.net",
                    me2dayHome: "http://me2day.net/me2daytest"
            },
location:{
name: "Seoul",
longitude: null,
latitude: null
},
media:{
"provider":"flickr",

"photoId":"2138021550",

"photoUrl":"http://farm3.static.flickr.com/2204/2138021550_4b8257d416.jpg",

"permalink":"http://www.flickr.com/photos/me2flickr/2138021550/"

}

}

]

rss 형식

rss 2.0 형식을 사용합니다.

create_post

Tue, 22 Jul 2008 22:10:17 +0900

create_post

사용자의 미투데이 페이지에 글을 작성합니다.

사용자 인증이 필요합니다.

URL

http://me2day.net/api/create_post/[미투데이 아이디].[응답형식]

[미투데이 아이디]는 글을 올릴 페이지의 미투데이 아이디입니다.

[응답형식]은 xml, json 중 하나를 지정합니다. 지정하지 않은 경우 xml을 응답형식으로 사용합니다.

예) http://me2day.net/api/create_post/codian.xml

파라미터

post[body] : 글 본문. 미투데이 글 작성 문법을 따릅니다.
post[tags] : 태그. 태그는 공백으로 구분합니다.
post[icon]: 아이콘번호. 1 부터 12까지 지정가능합니다. 지정하지 않는 경우 1번 생각글 아이콘이 지정됩니다.
post[kind] : deprecated. 글 종류. 생각글인 경우 1, 느낌글인 경우 2, 알림글인 경우 3을 사용합니다. 그 외의 숫자를 지정하거나 지정하지 않는 경우 생각글로 지정됩니다. post[icon] 파라미터를 지정한 경우 post[kind] 파라미터에 지정된 값은 무시되고 글 종류는 아이콘의 글 종류로 지정됩니다.
receive_sms: SMS 댓글 수신 여부. "true"로 지정한 경우 작성한 글에 작성된 댓글을 작성자의 핸드폰 문자 메시지로 발송합니다. 지정하지 않거나 "true" 이외의 값을 지정하는 경우 댓글을 핸드폰 문자 메시지로 발송하지 않습니다.
icon_url: 글 아이콘으로 사용할 이미지 URL을 지정합니다. 이미지 크기는 44X44 입니다. icon_url로 글 아이콘이 지정되는 경우 post[icon]으로 지정된 아이콘은 무시됩니다. 이 파라미터는 프리미엄 제휴 파트너만 사용할 수 있습니다.
callback_url: 아이콘을 클릭했을때 말풍선으로 표시될 HTML 마크업을 제공하는 URL을 지정합니다. HTML 마크업은 DOCTYPE XHTML 1.0 Strict 에 대해 유효한 형식으로 제공해야 하며 스크립트를 포함할 수 없습니다. callback_url을 통해 제공되는 마크업은 포함되는 페이지 디자인을 해치지 않는 범위에서 인라인 CSS 스타일을 지정할 수 있습니다. 이 파라미터는 프리미엄 제휴 파트너만 사용할 수 있습니다.
content_type: callback_url을 통해 제공하는 컨텐트 종류을 지정합니다. 지정 가능한 값은 "document", "photo", "video", "audio" 입니다. 지정하지 않는 경우 "document"가 지정됩니다. 이 파라미터는 프리미엄 제휴 파트너만 사용할 수 있습니다.
longitude : 경도 정보를 저장 합니다. float형태로 입력합니다.
latitude : 위도 정보를 저장 합니다. float형태로 입력합니다.
attachment : 사진파일(jpg)을 첨부해 글을 작성합니다. 업로드한 사진은 사용자가 지정한 사진서비스(flickr, 푸딩 등)에 업로드됩니다. attachment 에 사진파일을 지정해 업로드하기 위해서는 multipart/form-data로 인코딩해야 합니다. 업로드할 파일의 크기는 10M로 제한됩니다.

응답

생성된 글 정보

xml 형식

<?xml version="1.0" encoding="UTF-8"?>
<post>
<permalink>http://me2day.net/me2daytest/2007/04/22#01:17:16</permalink>
<body><a href="http://me2day.net">미투데이</a>에 글을 올립니다.</body>
<kind>think</kind>
<icon>http://me2day.net/images/post_think.gif</icon>
<tags>
    <tag>
      <name>me2api</name>
      <url>http://localhost:3000/me2daytest/tag/me2api</url>
    </tag>
    <tag>
      <name>create_post</name>
      <url>http://localhost:3000/me2daytest/tag/create_post</url>
    </tag>
    <tag>
      <name>글쓰기</name>
      <url>http://localhost:3000/me2daytest/tag/글쓰기</url>
    </tag>
</tags>
<me2dayPage>http://me2day.net/me2daytest</me2dayPage>
<pubDate>2007-04-22T01:17:16Z</pubDate>
<commentsCount>0</commentsCount>
<metooCount>0</metooCount>
<author>
    <id>me2daytest</id>
    <nickname>미투데이</nickname>
<face>http://me2day.net/images/user/codian/한글이름.jpg</face>

<homepage>http://me2day.net</homepage>
    <me2dayHome>http://me2day.net/me2daytest</me2dayHome>
</author>

<location>
    <longitude/>
    <latitiude/>
</location>
</post>

json 형식

{
    permalink: "http://me2day.net/me2daytest/2007/04/22#01:15:22",
    body: "\"\ubbf8\ud22c\ub370\uc774\":http://me2day.net \uc5d0 \uae00\uc744 \uc62c\ub9bd\ub2c8\ub2e4.",
    kind: "think",
    icon: "http://me2day.net/images/post_think.gif",
    tags: [
        {
            name: "me2api",
            url: "http://localhost:3000/me2daytest/tag/me2api"
    }, {
        name: "create_post",
        url: "http://localhost:3000/me2daytest/tag/create_post"
    }, {
        name: "\uae00\uc4f0\uae30",
        url: "http://localhost:3000/me2daytest/tag/\uae00\uc4f0\uae30"
    }
    ],
    me2dayPage: "http://me2day.net/me2daytest",
    pubDate: "2007-04-21T16:15:22Z",
    commentsCount: 0,
    metooCount: 0,
    author: {
        id: "me2daytest",
        nickname: "\ubbf8\ud22c\ub370\uc774",

face: "http://me2day.net/images/user/codian/한글이름.jpg",

        homepage: "http://me2day.net",
        me2dayHome: "http://me2day.net/me2daytest"
    }

    "location": {

        "longitude": 0.0,

        "latitude": 0.0

    }
}

get_comments

Fri, 27 Jun 2008 14:46:44 +0900

get_comments

지정한 글의 댓글 목록을 가져옵니다.

사용자 인증은 필요없습니다.

URL

http://me2day.net/api/get_comments.[응답형식]

응답형식은 xml, json 중 하나를 지정합니다. 지정하지 않은 경우 xml을 응답형식으로 사용합니다.

예) http://me2day.net/api/get_comments.xml

파라미터

post_id : 글 아이디. 글 아이디는 글의 퍼머링크를 사용하거나, get_posts나 get_latests등에서 리턴되는 post_id값을 이용하면 됩니다.

응답

댓글 목록

xml 형식

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

<comments post_id="p9h0r">

  <comment>

   <commentId>cacdfs</commentId>

<body>comment body</body>

   <pubDate>2007-06-16T16:25:05Z</pubDate>

   <author>

   <id>codian</id>

   <nickname>코디안</nickname>

<face>http://me2day.net/images/user/codian/profile.png</face>

   <me2dayHome>http://localhost:3000/codian</me2dayHome>

   </author>

  </comment>

</comments>

json 형식

{

post_id: "p9h0r",

comments: [

{

commentId: "cacdfs",

pubDate: "2007-06-16T16:25:05Z",

body: "comment body",

author: {

me2dayHome: "http://localhost:3000/codian",

nickname: "\ucf54\ub514\uc548",

face: "http://me2day.net/images/user/codian/profile.png",

id: "codian"

}

}

]

}

metoo

Thu, 26 Jun 2008 23:09:36 +0900

지정한 글에 미투한다.

사용자 인증이 필요합니다.

URL

http://me2day.net/api/metoo.[응답형식]

응답형식은 xml, json 중 하나를 지정합니다. 지정하지 않은 경우 xml을 응답형식으로 사용합니다.

예) http://me2day.net/api/metoo.xml

파라미터

post_id: 글 아이디. 글 아이디는 글의 퍼머링크를 사용하거나, get_posts나 get_latests등에서 리턴되는 post_id값을 이용하면 됩니다.

응답

성공여부

xml 형식인 경우

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

<error>

<code>0</code>

<message>성공했습니다.</message>

<description>미투했습니다.</description>

</error>

json 형식인 경우

{

"code":0,

"message":"성공했습니다.",

"description":"미투했습니다."

}

get_metoos

Thu, 26 Jun 2008 21:37:09 +0900

지정한 글에 미투한 사람 목록을 가져온다.

URL

http://me2day.net/api/get_metoos.[응답형식]

응답형식은 xml, json 중 하나를 지정합니다. 지정하지 않은 경우 xml을 응답형식으로 사용합니다.

예) http://me2day.net/api/get_metoos.xml?post_id = p9h0r

파라미터

post_id: 글 아이디. 글 아이디는 글의 퍼머링크를 사용하거나, get_posts나 get_latests등에서 리턴되는 post_id값을 이용하면 됩니다.

응답

미투한 사람 목록

xml 형식인 경우

<?xml version="1.0" encoding="UTF-8"?>
<metoos post_id="p9h0r">
<metoo>
<pubDate>2007-06-16T16:25:05Z</pubDate>
<author>
<id>codian</id>
<nickname>코디안</nickname>
<face>http://me2day.net/images/profile.png</face>
<me2dayHome>http://me2day.net/codian</me2dayHome>
</author>
</metoo>
</metoos>

json 형식인 경우

{
post_id: "p9h0r",
metoos: [
{
pubDate: "2007-06-16T16:25:05Z",
author: {
id: "codian",
nickname: "\ucf54\ub514\uc548",
face: "http://me2day.net/images/user/codian/profile.png",
me2dayHome: "http://localhost:3000/codian"
}
}
]
}