「Timelog」APIについて
Timelogでは、開発者向けにAPIを用意しております。
※メモ公開の仕様変更により、API経由の投稿もデフォルトは公開となっております。
「メモフレのみ公開」にする場合はメモの先頭に「/p」を、
「非公開」にする場合は「/s」を付けて投稿してください。
TimelogAPIに関連する外部のページ
Timelogツール集
Timelog APIをC#で使ってみる(matobowさん)
Timelog API perlサンプル(みのさん)
Timelog APIのrubyライブラリ(サロンパスさん)
TimelogのAPIを使ってみる(PHP)(makoto_kwさん)
機能：パブリックの発言を取得する
URL：http://api.timelog.jp/public_msg.asp
認証：無し
パラメータ：
cnt : 取得件数 [10-50] default:10
fmt : 取得形式 [ xml , rss , json , atom ] default:xml
stat : 取得条件 [bm:Bookmark , gn:Good&New , ph:みんなの写真] default:Public全て
jsonp : fmtがjson時、ここで指定した名前を返します
since : 指定時間以降の発言を取得します[since=200705161000]記号無しでお願いします
hc : 1を指定すれば評価(☆)の数も取得できます default:0
注：並び順は通常では時間での降順ですが、since指定がある場合のみ昇順になります
例：http://api.timelog.jp/public_msg.asp?cnt=20&fmt=rss
機能：自分とメモフレンドの発言を取得する
URL：http://api.timelog.jp/friends_msg.asp
認証：BASIC
パラメータ：
cnt : 取得件数 [10-50] default:10
fmt : 取得形式 [ xml , rss , json , atom ] default:xml
jsonp : fmtがjson時、ここで指定した名前を返します
since : 指定時間以降の発言を取得します[since=200705161000]記号無しでお願いします
hc : 1を指定すれば評価(☆)の数も取得できます default:0
注：並び順は通常時間で降順ですが、since指定がある場合のみ昇順になります
例：http://api.timelog.jp/friends_msg.asp?cnt=20
機能：自分宛のダイレクトメッセージを取得する
URL：http://api.timelog.jp/direct_msg.asp
認証：BASIC
パラメータ：
cnt : 取得件数 [10-50] default:10
fmt : 取得形式 [ xml , json ] default:xml
jsonp : fmtがjson時、ここで指定した名前を返します
例：http://api.timelog.jp/direct_msg.asp?cnt=20
機能：自分の発言を取得する
URL：http://api.timelog.jp/my_msg.asp
認証：BASIC
パラメータ：
cnt : 取得件数 [10-50] default:10
fmt : 取得形式 [ xml , rss , json , atom , ical] default:xml
jsonp : fmtがjson時、ここで指定した名前を返します
stat : 取得条件 [bm:Bookmark , td:ToDo , gn:Good&New , ca:集計 , jd:投票 , rv:Review ] default:DM以外全て
since : 指定日の発言を取得します[since=20070530]記号無しでお願いします
自分のメモIDを指定した場合は、指定したID以降の発言を取得します
tag : タグで絞り込みをする場合に指定します
hc : 1を指定すれば評価(☆)の数も取得できます default:0
注：並び順は通常では時間での降順ですが、since指定がある場合のみ昇順になります
ical(iCalendar)形式はGoogleCalendarでのみテストしてあります
例：http://api.timelog.jp/my_msg.asp?cnt=20&stat=bm&since=20070530
機能：自分宛のメッセージを取得する
URL：http://api.timelog.jp/res_msg.asp
認証：BASIC
パラメータ：
cnt : 取得件数 [10-50] default:10
fmt : 取得形式 [ xml , json ] default:xml
jsonp : fmtがjson時、ここで指定した名前を返します
hc : 1を指定すれば評価(☆)の数も取得できます default:0
例：http://api.timelog.jp/res_msg.asp?cnt=20
機能：自分のクリップデータを取得する
URL：http://api.timelog.jp/clip_msg.asp
認証：BASIC
パラメータ：
cnt : 取得件数 [10-50] default:10
fmt : 取得形式 [ xml , rss , json , atom ] default:xml
jsonp : fmtがjson時、ここで指定した名前を返します
hc : 1を指定すれば評価(☆)の数も取得できます default:0
例：http://api.timelog.jp/clip_msg.asp?cnt=20
機能：全てのタグ一覧を取得
URL：http://api.timelog.jp/tags.asp
認証：無し
パラメータ：
cnt : 取得件数 [10-50] default:all
fmt : 取得形式 [ xml , json ] default:xml
jsonp : fmtがjson時、ここで指定した名前を返します
stat : 取得条件 [asc:件数の少ない順 , desc:件数の多い順] default:名前順
例：http://api.timelog.jp/tags.asp?fmt=json
機能：自分の詳細な情報を取得
URL：http://api.timelog.jp/show.asp
認証：BASIC
パラメータ：
fmt : 取得形式 [ xml , json ] default:xml
jsonp : fmtがjson時、ここで指定した名前を返します
例：http://api.timelog.jp/show.asp
機能：自分のメモフレンドを取得
URL：http://api.timelog.jp/memofriends.asp
認証：BASIC
パラメータ：
cnt : 取得件数 [10-50 or all] default:10
fmt : 取得形式 [ xml , rss , json , atom , text] default:xml
jsonp : fmtがjson時、ここで指定した名前を返します
ac : アカウント(default:自分)
注：textの場合はIDのみ返します
例1：http://api.timelog.jp/memofriends.asp?cnt=20
例2：http://api.timelog.jp/memofriends.asp?cnt=all&fmt=text
機能：自分のファンを取得
URL：http://api.timelog.jp/fan.asp
認証：BASIC
パラメータ：
cnt : 取得件数 [10-50 or all] default:10
fmt : 取得形式 [ xml , rss , json , atom , text] default:xml
jsonp : fmtがjson時、ここで指定した名前を返します
ac : アカウント(default:自分)
注：textの場合はIDのみ返します
例1：http://api.timelog.jp/fan.asp?cnt=20
例2：http://api.timelog.jp/fan.asp?cnt=all&fmt=text
機能：相互フレンド状態のメモフレを取得
URL：http://api.timelog.jp/friends.asp
認証：BASIC
パラメータ：
cnt : 取得件数 [10-50 or all] default:10
fmt : 取得形式 [ xml , rss , json , atom , text] default:xml
jsonp : fmtがjson時、ここで指定した名前を返します
ac : アカウント(default:自分)
注：textの場合はIDのみ返します
例1：http://api.timelog.jp/friends.asp?cnt=20
例2：http://api.timelog.jp/friends.asp?cnt=all&fmt=text
機能：自分のプロフィール「聞いている曲」を更新
URL：http://api.timelog.jp/musicstatus.asp
認証：BASIC
パラメータ：
title : 表示内容
UTF8(encodeURIComponent)でPOSTしてください
titleを空白でPOSTすると表示内容がクリアされます
サンプルスクリプト
機能：新しいメモの投稿
URL：http://api.timelog.jp/new.asp
認証：BASIC
パラメータ：
text : 発言内容
remsgid : 元発言ID(発言単体での参照時にResのような形になります) 補足：
UTF8(encodeURIComponent)でPOSTしてください
こっそりgetも処理してますが、TEST用という事で
PHPでurlencode()を使用すると半角スペースが+になってしまうようです。rawurlencode()を使用してみてください。
ブラウザでTimelogを利用する場合と同様にコマンドやタグが利用できます
コマンド等のヘルプはこちらをご覧ください。
テスト用にnewtest.aspを用意してあります。
こちらを使った場合は発言が自動で非公開(/S)になります。
xmlは独自形式となっています。
xmlは独自形式となっています。
xmlは独自形式となっています。
xmlは独自形式となっています。
Timelogのロゴを利用されたい方は下記よりお好みのサイズ、ファイル形式を選んでご活用ください。
・timelog_logo_300×60.gif
・timelog_logo_150×30.gif
・timelog_logo_100×20.gif
・timelog_logo.ai
・timelog_web_services.gif
その他のデータに関しましても順次APIを用意していく予定です。
ご要望や不具合等に関しましてはこちらまでご連絡頂ければ幸いです。
Twitからのアクセスのように、API経由の投稿時にマークの記載等、できる限り柔軟に対応するつもりです。
よろしくお願い致します。
my_msg.aspにオプションを追加しました
・2009/01/06
memofriends.aspを追加しました
・2008/12/11
friends.asp及びfan.aspで自分以外のアカウントを指定できるようにしました
・2008/11/10
APIの制限時間を緩和しました。5秒以内に連続でアクセスされた場合は2回目以降は無視します
・2008/10/09
public_msg.aspのstatオプションに(ph)を追加。みんなの写真データが取得できるようにしました
clip_msg.aspで、自分のクリップデータを取得できるようにしました
・2008/10/07
メッセージ系取得XML及びJSONに評価数取得(hc)追加(1で有効)
・2008/10/06
APIのアクセスに制限時間を設けました。10秒以内に連続でアクセスされた場合は2回目以降は無視します
・2008/08/29
musicstatus.aspを追加
・2008/08/08
メッセージ系取得XML及びJSONにアカウント種別(statflag)追加(1:人,2:グループ)
・2008/07/17
メッセージ系取得XML及びJSONにメモ公開設定(dispflag)追加(0:公開,1:フレのみ,2:非公開)
・2008/05/16
my_msg.aspのパラメータにタグでの絞り込みを追加しました
・2008/05/13
my_msg.aspの出力形式にiCalendar形式を追加しました
fan.aspを追加
friend.asp及びfan.aspでxml形式で取得時に件数(recordcount)を取得できるようにしました
一部のnanoty表記の箇所をfinearcに修正いたしました
・2008/04/25
friends_msg.aspで、参加中のグループの発言も取得できるようにしました
JSON,XML形式でデータの取得を行った場合、グループ発言の場合は、
toid,tonameにグループ、fromidfromnameに発言者の情報が入ります
・2007/05/31
JSON形式で取得する場合のデータを増やしました。xmlで取得する場合に近い情報が取得可能です
メモ取得時にToDoの時間(tododate)と元メモID(replyid)と
宛先ニックネーム(toname)を取得できるようにしました
・2007/05/30
取得API(my_msg.asp)を追加。自分の発言を条件付きで取得できます
・2007/05/24
第一回「Timelog API」コンテストがスタートしました
・2007/05/23
投稿API(new.asp)に引数(remsgid)を追加
・2007/05/21
タグ情報取得追加
・2007/05/16
メッセージ系取得XML及びJSONにタグ情報(tag)追加(タグ毎にカンマ区切り)
自分のデータを取得機能追加（使用タグを取得可能） [show.asp]
自分宛のダイレクトメッセージ取得機能追加 [direct_msg.asp]
メッセージ系取得の引数にsince追加
※メモ公開の仕様変更により、API経由の投稿もデフォルトは公開となっております。
「メモフレのみ公開」にする場合はメモの先頭に「/p」を、
「非公開」にする場合は「/s」を付けて投稿してください。
TimelogAPIに関連する外部のページ
Timelogツール集
Timelog APIをC#で使ってみる(matobowさん)
Timelog API perlサンプル(みのさん)
Timelog APIのrubyライブラリ(サロンパスさん)
TimelogのAPIを使ってみる(PHP)(makoto_kwさん)
public_msg.asp
機能：パブリックの発言を取得する
URL：http://api.timelog.jp/public_msg.asp
認証：無し
パラメータ：
cnt : 取得件数 [10-50] default:10
fmt : 取得形式 [ xml , rss , json , atom ] default:xml
stat : 取得条件 [bm:Bookmark , gn:Good&New , ph:みんなの写真] default:Public全て
jsonp : fmtがjson時、ここで指定した名前を返します
since : 指定時間以降の発言を取得します[since=200705161000]記号無しでお願いします
hc : 1を指定すれば評価(☆)の数も取得できます default:0
注：並び順は通常では時間での降順ですが、since指定がある場合のみ昇順になります
例：http://api.timelog.jp/public_msg.asp?cnt=20&fmt=rss
friends_msg.asp
機能：自分とメモフレンドの発言を取得する
URL：http://api.timelog.jp/friends_msg.asp
認証：BASIC
パラメータ：
cnt : 取得件数 [10-50] default:10
fmt : 取得形式 [ xml , rss , json , atom ] default:xml
jsonp : fmtがjson時、ここで指定した名前を返します
since : 指定時間以降の発言を取得します[since=200705161000]記号無しでお願いします
hc : 1を指定すれば評価(☆)の数も取得できます default:0
注：並び順は通常時間で降順ですが、since指定がある場合のみ昇順になります
例：http://api.timelog.jp/friends_msg.asp?cnt=20
direct_msg.asp
機能：自分宛のダイレクトメッセージを取得する
URL：http://api.timelog.jp/direct_msg.asp
認証：BASIC
パラメータ：
cnt : 取得件数 [10-50] default:10
fmt : 取得形式 [ xml , json ] default:xml
jsonp : fmtがjson時、ここで指定した名前を返します
例：http://api.timelog.jp/direct_msg.asp?cnt=20
my_msg.asp
機能：自分の発言を取得する
URL：http://api.timelog.jp/my_msg.asp
認証：BASIC
パラメータ：
cnt : 取得件数 [10-50] default:10
fmt : 取得形式 [ xml , rss , json , atom , ical] default:xml
jsonp : fmtがjson時、ここで指定した名前を返します
stat : 取得条件 [bm:Bookmark , td:ToDo , gn:Good&New , ca:集計 , jd:投票 , rv:Review ] default:DM以外全て
since : 指定日の発言を取得します[since=20070530]記号無しでお願いします
自分のメモIDを指定した場合は、指定したID以降の発言を取得します
tag : タグで絞り込みをする場合に指定します
hc : 1を指定すれば評価(☆)の数も取得できます default:0
注：並び順は通常では時間での降順ですが、since指定がある場合のみ昇順になります
ical(iCalendar)形式はGoogleCalendarでのみテストしてあります
例：http://api.timelog.jp/my_msg.asp?cnt=20&stat=bm&since=20070530
res_msg.asp
機能：自分宛のメッセージを取得する
URL：http://api.timelog.jp/res_msg.asp
認証：BASIC
パラメータ：
cnt : 取得件数 [10-50] default:10
fmt : 取得形式 [ xml , json ] default:xml
jsonp : fmtがjson時、ここで指定した名前を返します
hc : 1を指定すれば評価(☆)の数も取得できます default:0
例：http://api.timelog.jp/res_msg.asp?cnt=20
clip_msg.asp
機能：自分のクリップデータを取得する
URL：http://api.timelog.jp/clip_msg.asp
認証：BASIC
パラメータ：
cnt : 取得件数 [10-50] default:10
fmt : 取得形式 [ xml , rss , json , atom ] default:xml
jsonp : fmtがjson時、ここで指定した名前を返します
hc : 1を指定すれば評価(☆)の数も取得できます default:0
例：http://api.timelog.jp/clip_msg.asp?cnt=20
tags.asp
機能：全てのタグ一覧を取得
URL：http://api.timelog.jp/tags.asp
認証：無し
パラメータ：
cnt : 取得件数 [10-50] default:all
fmt : 取得形式 [ xml , json ] default:xml
jsonp : fmtがjson時、ここで指定した名前を返します
stat : 取得条件 [asc:件数の少ない順 , desc:件数の多い順] default:名前順
例：http://api.timelog.jp/tags.asp?fmt=json
show.asp
機能：自分の詳細な情報を取得
URL：http://api.timelog.jp/show.asp
認証：BASIC
パラメータ：
fmt : 取得形式 [ xml , json ] default:xml
jsonp : fmtがjson時、ここで指定した名前を返します
例：http://api.timelog.jp/show.asp
memofriends.asp
機能：自分のメモフレンドを取得
URL：http://api.timelog.jp/memofriends.asp
認証：BASIC
パラメータ：
cnt : 取得件数 [10-50 or all] default:10
fmt : 取得形式 [ xml , rss , json , atom , text] default:xml
jsonp : fmtがjson時、ここで指定した名前を返します
ac : アカウント(default:自分)
注：textの場合はIDのみ返します
例1：http://api.timelog.jp/memofriends.asp?cnt=20
例2：http://api.timelog.jp/memofriends.asp?cnt=all&fmt=text
fan.asp
機能：自分のファンを取得
URL：http://api.timelog.jp/fan.asp
認証：BASIC
パラメータ：
cnt : 取得件数 [10-50 or all] default:10
fmt : 取得形式 [ xml , rss , json , atom , text] default:xml
jsonp : fmtがjson時、ここで指定した名前を返します
ac : アカウント(default:自分)
注：textの場合はIDのみ返します
例1：http://api.timelog.jp/fan.asp?cnt=20
例2：http://api.timelog.jp/fan.asp?cnt=all&fmt=text
friends.asp
機能：相互フレンド状態のメモフレを取得
URL：http://api.timelog.jp/friends.asp
認証：BASIC
パラメータ：
cnt : 取得件数 [10-50 or all] default:10
fmt : 取得形式 [ xml , rss , json , atom , text] default:xml
jsonp : fmtがjson時、ここで指定した名前を返します
ac : アカウント(default:自分)
注：textの場合はIDのみ返します
例1：http://api.timelog.jp/friends.asp?cnt=20
例2：http://api.timelog.jp/friends.asp?cnt=all&fmt=text
musicstatus.asp
機能：自分のプロフィール「聞いている曲」を更新
URL：http://api.timelog.jp/musicstatus.asp
認証：BASIC
パラメータ：
title : 表示内容
UTF8(encodeURIComponent)でPOSTしてください
titleを空白でPOSTすると表示内容がクリアされます
サンプルスクリプト
new.asp
機能：新しいメモの投稿
URL：http://api.timelog.jp/new.asp
認証：BASIC
パラメータ：
text : 発言内容
remsgid : 元発言ID(発言単体での参照時にResのような形になります) 補足：
UTF8(encodeURIComponent)でPOSTしてください
こっそりgetも処理してますが、TEST用という事で
PHPでurlencode()を使用すると半角スペースが+になってしまうようです。rawurlencode()を使用してみてください。
ブラウザでTimelogを利用する場合と同様にコマンドやタグが利用できます
コマンド等のヘルプはこちらをご覧ください。
テスト用にnewtest.aspを用意してあります。
こちらを使った場合は発言が自動で非公開(/S)になります。
メッセージ系取得時のxmlの内容について
xmlは独自形式となっています。
<?xml version="1.0" encoding="UTF-8"?>
<memos>
<title>TimeLog finearc</title>
<link rel="alternate" type="text/html" href="http://timelog.jp"/>
<modified>2007/05/15 13:13:32</modified>
<author>
<id>取得者のID</id>
<name>取得者のニックネーム</name>
<image>
<normal>取得者の画像(75x75)</normal>
<thumb>取得者の画像(35x35)</thumb>
<small>取得者の画像(25x25)</small>
</image>
</author>
<entry>
<id>メモID</id>
<dispflag>公開設定(0:公開,1:フレのみ,2:非公開)</dispflag>
<memo>メモの内容</memo>
<tag>使用タグ</tag>
<toid>宛先ID</toid>
<toname>宛先ニックネーム</toname>
<tododate>ToDo日時</tododate>
<replyid>元メモID</replyid>
<tag>タグ</tag>
<author>
<id>投稿者ID</id>
<name>投稿者ニックネーム</name>
<statflag>アカウント種別(1:人,2:グループ)</statflag>
<image>
<normal>投稿者の画像(75x75)</normal>
<thumb>投稿者の画像(35x35)</thumb>
<small>投稿者の画像(25x25)</small>
</image>
<fromid>グループでの発言者ID</fromid>
<fromname>グループでの発言者ニックネーム</fromname>
</author>
<link rel="alternate" type="text/html" href="メモのリンク"/>
<modified>メモ投稿日</modified>
<star>評価数(☆)</star>
</entry>
<entry>
.
.
.
</entry>
</memos>
自分の詳細な情報取得時のxmlの内容について
xmlは独自形式となっています。
<?xml version="1.0" encoding="UTF-8"?> <show> <title>TimeLog finearc</title> <link rel="alternate" type="text/html" href="http://timelog.jp"/> <modified>2007/05/15 13:58:39</modified> <user> <id>取得者のID</id> <name>取得者のニックネーム</name> <url>取得者のTimelogPage</url> <prof_url>取得者のURL</prof_url> <prof_msg>取得者の自己紹介</prof_msg> <tags>取得者の使用タグ</tags> <image> <normal>取得者の画像(75x75)</normal> <thumb>取得者の画像(35x35)</thumb> <small>取得者の画像(25x25)</small> </image> </user> </show>
フレンド及びファン取得時のxmlの内容について
xmlは独自形式となっています。
<?xml version="1.0" encoding="UTF-8"?> <friends> <title>TimeLog finearc</title> <link rel="alternate" type="text/html" href="http://timelog.jp"/> <modified>2007/05/15 13:58:39</modified> <author> <id>取得者のID</id> <name>取得者のニックネーム</name> <image> <normal>取得者の画像(75x75)</normal> <thumb>取得者の画像(35x35)</thumb> <small>取得者の画像(25x25)</small> </image> </author> <recordcount>件数</recordcount> <entry> <id>投稿者ID</id> <name>投稿者ニックネーム</name> <image> <normal>投稿者の画像(75x75)</normal> <thumb>投稿者の画像(35x35)</thumb> <small>投稿者の画像(25x25)</small> </image> <modified></modified> </entry> <entry> . . . </entry> </friends>
タグ取得時のxmlの内容について
xmlは独自形式となっています。
<?xml version="1.0" encoding="UTF-8"?> <tags> <title>TimeLog finearc</title> <link rel="alternate" type="text/html" href="http://timelog.jp"/> <modified>2007/05/21 15:58:39</modified> <tagdata> <tag>タグ</tag> <cnt>件数</name> </tagdata> . . . </tags>
Timelogのロゴ利用について
Timelogのロゴを利用されたい方は下記よりお好みのサイズ、ファイル形式を選んでご活用ください。
・timelog_logo_300×60.gif
・timelog_logo_150×30.gif
・timelog_logo_100×20.gif
・timelog_logo.ai
・timelog_web_services.gif
その他のデータに関しましても順次APIを用意していく予定です。
ご要望や不具合等に関しましてはこちらまでご連絡頂ければ幸いです。
Twitからのアクセスのように、API経由の投稿時にマークの記載等、できる限り柔軟に対応するつもりです。
よろしくお願い致します。
更新履歴
・2009/04/16my_msg.aspにオプションを追加しました
・2009/01/06
memofriends.aspを追加しました
・2008/12/11
friends.asp及びfan.aspで自分以外のアカウントを指定できるようにしました
・2008/11/10
APIの制限時間を緩和しました。5秒以内に連続でアクセスされた場合は2回目以降は無視します
・2008/10/09
public_msg.aspのstatオプションに(ph)を追加。みんなの写真データが取得できるようにしました
clip_msg.aspで、自分のクリップデータを取得できるようにしました
・2008/10/07
メッセージ系取得XML及びJSONに評価数取得(hc)追加(1で有効)
・2008/10/06
APIのアクセスに制限時間を設けました。10秒以内に連続でアクセスされた場合は2回目以降は無視します
・2008/08/29
musicstatus.aspを追加
・2008/08/08
メッセージ系取得XML及びJSONにアカウント種別(statflag)追加(1:人,2:グループ)
・2008/07/17
メッセージ系取得XML及びJSONにメモ公開設定(dispflag)追加(0:公開,1:フレのみ,2:非公開)
・2008/05/16
my_msg.aspのパラメータにタグでの絞り込みを追加しました
・2008/05/13
my_msg.aspの出力形式にiCalendar形式を追加しました
fan.aspを追加
friend.asp及びfan.aspでxml形式で取得時に件数(recordcount)を取得できるようにしました
一部のnanoty表記の箇所をfinearcに修正いたしました
・2008/04/25
friends_msg.aspで、参加中のグループの発言も取得できるようにしました
JSON,XML形式でデータの取得を行った場合、グループ発言の場合は、
toid,tonameにグループ、fromidfromnameに発言者の情報が入ります
・2007/05/31
JSON形式で取得する場合のデータを増やしました。xmlで取得する場合に近い情報が取得可能です
メモ取得時にToDoの時間(tododate)と元メモID(replyid)と
宛先ニックネーム(toname)を取得できるようにしました
・2007/05/30
取得API(my_msg.asp)を追加。自分の発言を条件付きで取得できます
・2007/05/24
第一回「Timelog API」コンテストがスタートしました
・2007/05/23
投稿API(new.asp)に引数(remsgid)を追加
・2007/05/21
タグ情報取得追加
・2007/05/16
メッセージ系取得XML及びJSONにタグ情報(tag)追加(タグ毎にカンマ区切り)
自分のデータを取得機能追加（使用タグを取得可能） [show.asp]
自分宛のダイレクトメッセージ取得機能追加 [direct_msg.asp]
メッセージ系取得の引数にsince追加