mogya / tm_twitter_api

twitter api wrapper for titanuim mobile
65 stars 22 forks source link

twitter_api.js

This is a library to call twitter api from titanium mobile project.

How to use

Ti.include("lib/twitter_api.js");
//initialization
var twitterApi = new TwitterApi({
    consumerKey:'YOUR CONSUMER KEY of twitter API',
    consumerSecret:'YOUR SECRET of twitter API'
});
twitterApi.init(); 

When you call twitterApi.init, the library open a web browser UI to request the oauth authorization process if needs.

//status update
twitterApi.statuses_update({
    onSuccess: function(responce){
        alert('tweet success');
        Ti.API.info(responce);
    },
    onError: function(error){
        Ti.API.error(error);
    },
    parameters:{status: 'yah! this is my first tweet from twitter_api.js! '}
});

//get tweets
twitterApi.statuses_home_timeline({
    onSuccess: function(tweets){
        for(var i=0;i<tweets.length;i++){
            var tweet = tweets[i];
            // now you can use tweet.user.name, tweet.text, etc..
        }
    },
    onError: function(error){
        Ti.API.error(error);
    }
});

Some API has optional parameters.

twitterApi.users_show({
    user_id:'5574572', //parameters.
    onSuccess: function(ret){
        Ti.API.debug(ret);
    }
});

license

Apache License 2.0

Thanks to

This library is forked from 'Twitter oAuth Implementation for Titanium Mobile' by David Riccitelli.

if you like the OAuth Adapter, consider donating to David.

See also 'Re: Twitter oAuth Implementation for Titanium Mobile' about oauth-adapter story.

Also using oauth.js and sha1.js as original OAuth Adapter.

FAQ: " I got an error 'Authentication needed' "

To update twitter status, you need "Read and Write" permission on twitter API application setting.

Japanese

英語は疲れますね:-)

Titanium mobile から twitter APIを呼び出すためのラッパークラスです。 同様の機能を持つものとして、David Riccitelli'Twitter oAuth Implementation for Titanium Mobile'が有名なのですが、 このライブラリ、GETができなかったり、APIの呼び出しが終わるたびに毎回ポップアップを出さないといけないとか、いろいろ問題があったので titanium-hatena-oauth-sampleを参考に書き換えました。

ついでに、twitterAPIを簡単に呼び出せるようにしたtwitter_api.jsというラッパークラスを作りました。 APIドキュメントに書いてある名前と引数でAPIを呼び出すことができて、onSuccessとか、onErrorといった普通のコールバック関数で処理を行うことができます。 詳しくは上記(英語の部分の)サンプルコードをご覧ください。