Changes

C4LN 2012: Intro to the Twitter API

573 bytes added, 12:25, 24 May 2012
no edit summary
* https://dev.twitter.com/ is API central.
** other useful things linked therefrom: [https://dev.twitter.com/status API Status], [https://dev.twitter.com/issues API Known Issues], blog & discussion
* '''https://dev.twitter.com/docs is the main documentation area'''
** you'll find yourself spending a lot of time here =)
=== Parts ===
The twitter API breaks down into three main areas
* the '''REST API'''
** query→response based access
** this is what you're most likely to use
* the '''Streaming API'''
** aka ''drinking from the firehose'' =)
** push-based communication w/ v.high ratelimit
* the '''Search API'''
** just like it says on the tin
** also trending topics
==== REST API ====
* query→response based access
* the mainstay of the API; the first part of it you'll want to be concerned with, and the part you'll likely use most
 
==== Streaming API ====
* aka ''drinking from the firehose'' =)
* persistent connection
* push-based communication w/ v.high ratelimit (1% of ''all tweets'')
 
==== Search API ====
* just like it says on the tin
* also trending topics
== Find your library ==
https://dev.twitter.com/docs/twitter-librarieshas a good list
* Perl: [http://search.cpan.org/dist/Net-Twitter Net::Twitter]
== Creating a new app ==
=== First steps ===
* https://dev.twitter.com/apps/new
* sign in with your twitter account
* fill out basic info about your app
* agree to be a good citizen, as detailed below
* https://dev.twitter.com/terms/api-terms* https://support.twitter.com/articles/76915 - automation rules and best practicesHuzzah! You have your very own app!
== Rate limits =Setup === * Details tab* Settings tab:** Application type:*** Read*** Read/Write*** Read/Write/Access DMs * receive OAuth keys   == Bot-specific stuff == * create an account for your bot* authorize it on your app 
== Rules of Conduct ==
=== Repeated tweets ===
=== General Rules of the Road and TOS === * https://dev.twitter.com/terms/api-terms* https://support.twitter.com/articles/76915 - automation rules and best practices === Rate limits === *  === Other gotchas === * Repeated tweets
22
edits