@twitterapi at SocialApp Workshop

TM

Saturday, July 24, 2010

TM

@twitterapi

@herokuJuly 24, 2010

#appworkshop @themattharris @heroku


TM

About us


TM

The team


TM

@themattharrisAbout 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.comThe developer portal


TM

Creating an appYour own small playground


TM


TM

Browsing docs


TM


TM

OAuthpocalypseThe 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

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

ActionScript/FlashC/C++C#/.NETClojureErlangJavaJavaScript

Objective-C/Cocoa & iPhone ProgrammingPerlPHPPythonQtRubyScala




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


‣ include_entities



TM


‣ 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

‣ /1/geo/similar_places

‣ not found in search, find by name

‣ /1/geo/place

‣ still not found, create a new place

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


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

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

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 ...‣ /1/geo/similar_places

‣ 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=&autocomplete=&long=-‐122.400612831116&granularity=&name=Twitter", "type": "similar_places",


http://api.twitter.com/1/geo/similar_places.json?query=&contained_within=&lat=37.7821120598956&accuracy=&autocomplete=&long=-122.400612831116&granularity=&name=Twitter






TM

More Info... Check outbit.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>


http://platform.twitter.com/anywhere.js?id=YOUR_API_KEY&v=1

http://platform.twitter.com/anywhere.js?id=YOUR_API_KEY&v=1

TM

More Info... Check outbit.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'] ));


https://api.twitter.com/oauth/access_token'

https://api.twitter.com/oauth/access_token'

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 APINear-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


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

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

TM

Follow some users‣ Curl with Basic Auth or Twurl with OAuth


‣ Pass up to 400 user_ids, comma seperated

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


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


TM

Filter by keyword‣ Curl with Basic Auth or Twurl with OAuth


‣ 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

More Info... Check outbit.ly/streaming_api


TM

Stay Informed... Joinbit.ly/twitter-anywhere-talkbit.ly/twitter-dev-talk

Important [email protected]/twitter-api-announce


TM

Help... Check outdev.twitter.com


TM

Questions? Follow us attwitter.com/twitterapitwitter.com/themattharris


TM


@twitterapi at SocialApp Workshop

Technology

Transcript of @twitterapi at SocialApp Workshop