@twitterapi at SocialApp Workshop

TM

Saturday, July 24, 2010

@twitterapi
#appworkshop @themattharris @heroku

@heroku TM

July 24, 2010

About us

TM


The team

TM


@themattharris
About me

TM


What is ?
The Twitter Platform

TM


What is ?
‣ REST API
‣ provides the “basic” Twitter functionality - tweet, follow, etc.
‣ all functions available on your timeline on twitter.com
‣ Search API
‣ real-time search index
‣ get “top tweets” / relevant search results
‣ Streaming API
‣ HTTP long-poll connection
‣ tweets come out of the system in real-time TM


Limits
‣ 350 API calls/hour using OAuth against api.twitter.com
‣ Unauthenticated it goes against the source IP address
‣ Authenticated it goes against the calling user
‣ “Natural” limits on
‣ number of tweets sent
‣ number of DMs sent
‣ number of followings / unfollowings
‣ Status limits
‣ No duplicate tweets
‣ No malware links in tweets TM


dev.twitter.com
The developer portal

TM


Creating an app
Your own small playground

TM


Browsing docs

TM


OAuthpocalypse
The day is 30th June 16th August 2010

TM


What you need to know
‣ All applications must be using OAuth for the REST API
‣ Streaming API will still support Basic Auth
‣ Search API has no auth
‣ Replace curl with twurl for debugging

http://dev.twitter.com/pages/auth_overview
http://github.com/marcel/twurl
TM


OAuth Methods
‣ Web must use three legged OAuth
‣ Desktop and mobile apps can also use out-of-band OAuth
‣ Some desktop and mobile apps will be considered for xAuth

TM


xAuth not XAuth

xAuth is OAuth

http://dev.twitter.com/pages/xauth

TM


Check your host!

api.twitter.com

twitter.com
TM


Libraries
ActionScript/Flash Objective-C/Cocoa & iPhone Programming
C/C++ Perl
C#/.NET PHP
Clojure Python
Erlang Qt
Java Ruby
JavaScript Scala

http://dev.twitter.com/pages/oauth_libraries

TM


twurl
‣ http://github.com/marcel/twurl
‣ Command line tool to interact with using OAuth
‣ Transparently handles OAuth signing against
‣ POST and GET data
‣ Trace requests

TM


Timelines

TM


Timeline Endpoints
‣ /1/statuses/public_timeline
‣ /1/statuses/home_timeline
‣ /1/statuses/friends_timeline
‣ /1/statuses/user_timeline
‣ /1/statuses/mentions
‣ /1/statuses/retweeted_by_me
‣ /1/statuses/retweeted_to_me
‣ /1/statuses/retweets_of_me

TM


Modifiers
‣ include_rts

Accepted values: true, 1, t

TM


Modifiers
‣ include_rts
‣ include_entities


TM


Modifiers
‣ include_rts
‣ include_entities
‣ trim_user


TM


Geo

TM


Endpoints
‣ /1/geo/search
‣ /1/geo/similar_places
‣ /1/geo/reverse_geocode
‣ /1/geo/id/:id
‣ /1/geo/place

TM


Create a place
‣ /1/geo/search
‣ show what’s nearby
‣ not found in search, find by name
‣ /1/geo/place
‣ still not found, create a new place

http://api.twitter.com/1/geo/place

TM


Get location (if allowed)

TM


/1/geo/search - suggest nearby

TM


/1/geo/similar_places - find by name

TM


/1/geo/place - not it? create it

TM


Technical Info ...
‣ must run this first to get a creation_token

TM


Technical Info ...

],

"full_name":
"Twitter
HQ,
San
Francisco",

"place_type":
"poi"

}

],

"token":
"36179c9bf78835898ebf521c1defd4be"

},

"query":
{

"url":
"http://api.twitter.com/1/geo/similar_places.json?
query=&contained_within=&lat=37.7821120598956&accuracy=&autocompl
ete=&long=-‐122.400612831116&granularity=&name=Twitter",

"type":
"similar_places",

TM


More Info... Check out
bit.ly/twitter-api-geo

TM


@anywhere

TM


Core Features
‣ Hovercards
‣ Tweet Box
‣ Follow Buttons
‣ Linkify
‣ Connect with Twitter

TM


Easiest Example
<head>
<script
src="http://platform.twitter.com/anywhere.js?id=YOUR_API_KEY&v=1">
</script>
<script type="text/javascript">
twttr.anywhere(function(T) {
T.hovercards();
T("#follow-placeholder").followButton('themattharris');
T("#tbox").tweetBox();
});
</script>
</head>

TM


bit.ly/anywhere-begin

TM


Bridge Code
@anywhere to api.twitter.com

TM


Overview

‣ Use connect with Twitter
‣ Hook into authComplete
‣ Send the bridge code to your server
‣ Exchange the bridge code using /oauth/access_token
‣ Verify

TM


Use connect with Twitter
T("#connect-placeholder").connectButton({
authComplete: function(user, bridge_code) {
$.post('/mypage.php', {
'bridge_code' : bridge_code
});
}
});

TM


Hook into authComplete
});
}
});

TM


Send to your server
});
}
});

TM


Exchange the bridge code

‣ POST to https://api.twitter.com/oauth/access_token
‣ Parameter is oauth_bridge_code
‣ Sign with your applications consumer token and secret

TM


Exchange the token - PHP
$http->request(
'POST',
'https://api.twitter.com/oauth/access_token', array(
'oauth_bridge_code' => $_REQUEST['bridge_code']
)
);

TM


Verify

‣ Using the user tokens call
/1/account/verify_credentials.json
‣ Generate the signature
sha1( user_id + consumer_secret )
‣ Compare the signature with the cookie value in
twitter_anywhere_identity

TM


Streaming API
Near-Realtime Access to Public Statuses

TM


Streaming API
‣ A persistent connection to Twitter servers
‣ Get pushed a tweet that matches your predicate in “real-time”
‣ Server to server integrations

TM


Basic Usage
‣ Curl with Basic Auth or Twurl with OAuth
‣ One connection per username permitted

http://stream.twitter.com/1/statuses/sample.json

TM


Follow some users
‣ Pass up to 400 user_ids, comma seperated

http://stream.twitter.com/1/statuses/filter.json

TM


Filter by keyword
‣ Pass up to 200 keywords, comma seperated
‣ Example: Twitter will return statuses which contain: TWITTER,
twitter, "Twitter", twitter., #twitter and @twitter

http://stream.twitter.com/1/statuses/filter.json

TM


Streaming API - Default Level
‣ 200 x Keywords
‣ 400 x Follow userids
‣ 10 x 1-degree location boxes

TM


bit.ly/streaming_api

TM


Stay Informed... Join
bit.ly/twitter-anywhere-talk
bit.ly/twitter-dev-talk

Important Stuff
@twitterapi
status.twitter.com
bit.ly/twitter-api-announce

TM


Help... Check out
dev.twitter.com

TM


Questions? Follow us at
twitter.com/twitterapi
twitter.com/themattharris

TM


@twitterapi at SocialApp Workshop

Recommended

Recommended

More Related Content

Viewers also liked

Viewers also liked (18)

More from Matt Harris

More from Matt Harris (9)

Recently uploaded

Recently uploaded (20)

@twitterapi at SocialApp Workshop