2010年4月29日木曜日

TwitterAPIライブラリ(JavaScript)更新

TwitterAPIライブラリを更新しました。twitterapi-v010.js
一通り関数を揃えました。
対応したAPIはREST GETで認証不要のものです。
関数一覧も書いておきます。パラメータの第一パラメータのコールバック関数は必須。その他のパラメータでも必須なものは太字にしました。パラメータを省略する場合はnullを指定、パラメータの数はノーチェックなので、短かった場合はそれ以降nullを指定したのと同じ(になると思います)。
Rate Limitが”あり”のものについては関数の中で残回数をチェックして、残回数がなかったらAPIを呼ばないようにしてあります。
機能とか戻ってくる値とかパラメータの意味とかはTwitter API wikiを参照ください。(書くのが面倒くさいので。すみません。)
また、UsersSuggestionsCategory、GeoNearbyPlaces、GeoReverseGeocode、GeoId については今のところうまく動きません。(Twitterからの応答がJSON形式のままでコールバック関数でくるんでくれていません。どこが悪いのかなぁ。)
関数名 パラメータ Rate limit 対応するTwitter API Wiki
StatusesFriends callback, id, user_id, screen_name, cursor あり Twitter REST API Method: statuses friends
StatusesFollowers callback, id, user_id, screen_name, cursor あり Twitter REST API Method: statuses followers
StatusesPublicTimeline callback あり Twitter REST API Method: statuses public_timeline
StatusesShow callback, id あり Twitter REST API Method: statuses show
StatusesUserTimeline callback, id, user_id, screen_name, since_id, max_id, count, page あり Twitter REST API Method: statuses user_timeline
UsersShow callback, id, user_id, screen_name
(id、 user_id、 screen_nameのうちどれか一つ必須)
あり Twitter REST API Method: users show
UsersSuggestions callback あり Twitter REST API Method: GET users suggestions
UsersSuggestionsCategory callback, slug あり Twitter REST API Method: GET users suggestions category
AccountRateLimitStatus callback なし Twitter REST API Method: account rate_limit_status
UserListsListidStatuses callback, user, list_id, since_id, max_id, per_page, page あり Twitter REST API Method: GET /:user/lists/:list_id/statuses
FriendshipsExists callback, user_a, user_b あり Twitter REST API Method: friendships exists
FriendshipsShow callback, source_id, source_screen_name, target_id, target_screen_name
(source_id、source_screen_nameのどれか必須。
target_id、 target_screen_nameのどれか必須)
あり Twitter REST API Method: friendships show
FriendsIds callback, id, user_id, screen_name, cursor あり Twitter REST API Method: friends ids
FollowersIds callback, id, user_id, screen_name, cursor あり Twitter REST API Method: followers ids
TrendsAvailable callback, lat, long あり Twitter REST API Method: trends available
TrendsLocation callback, woeid あり Twitter REST API Method: trends location
GeoNearbyPlaces callback, lat, long, ip, accuracy, granularity, max_results あり Twitter REST API Method: GET geo nearby_places
GeoReverseGeocode callback, lat, long, accuracy, granularity, max_results あり Twitter REST API Method: GET geo reverse_geocode
GeoId callback, id あり Twitter REST API Method: GET geo ID
HelpTest callback なし Twitter REST API Method: help test

関数の使用例は下記の通り。
<html>
<head>
<meta http-equiv="Content-Script-Type" content="text/javascript">
<script type="text/javascript" src="twitterapi-v010.js" charset="utf-8"></script>
<script type="text/javascript">
//<!--
function test()

    UserListsListidStatuses(callback,"twitterapi","team",null,null,3);
}
//コールバック関数
function callback(Response) //TwitterからのレスポンスはJSON形式
{
    ClearSession(Response);  //後処理
    var t = document.getElementById("test");
    t.innerHTML = Response[0].text;
}
//-->
</script>
</head>
<body>
<form>
<input type="button" value="テスト" onclick="test()">
</form>
<div id="test"></div>
</body>
</html>


0 件のコメント:

コメントを投稿