api

Entries tagged with “api”.


Daniel Sandler is experimenting with using twitter for comments, and makes some very good points about comments on the web in the process. Essentially, he pulls in the content of any tweet that references his post’s full URL, TinyURL, or even just the TinyURL hash. This has the very nice effect of forcing people who want to comment on his post to own their words. Their comments will be public to their own audience, and so are more likely to be constructive and civil.

Twitter comments on Daniel’s website.

Tying your tweet to a particular page online is awkward though, due to Twitter’s 140-character limit. URLs were designed to be expressive, but not necessarily space-efficient (compare them to DOI or ISBN codes). Twitter’s recent rise has driven the increased use of URL-shortening services like TinyURL and bit.ly, which were originally designed because of the limitations of email clients that weren’t able to correctly break up an URL that was wider than the 80-character wide text columns used at the time.

We seem to have replaced one limitation with another though. By feeding all URLs through minimisation services, readers lose all context about the page they are about to open — is it a video? What domain is it on? Have I visited it before? There are some links that I would be disinclined to click on when using my iPhone, but with minimised URLs, you don’t know what you’ve got until it begins to load in. Plus, there’s the nightmare scenario that the URL service dies, and since their databases are kept private, all that information is lost.

I think URL shortening services could be obviated if Twitter started treating URLs a little differently. There are two main audiences for twitter tweets: mobile phone users who receive tweets as SMS messages (this is the original reason why twitter has 140-character limits), and users who visit the twitter website, or use one of the myriad desktop and smartphone applications to keep up with tweets. These users are not concerned about the character limit in the same way. I would expect this group of people to be growing faster than those who get tweets via SMS.

Ideally, Twitter would disregard URL content as part of the character limit. If you think about it, the URL http://tinyurl.com/cxt59m (this page) conveys almost no information whatsoever. It could as easily be replaced with some single-character replacement in SMS messages (whose users are much less likely to actually follow links than web/applications users anyway). [On further reflection, it is clear that this wouldn't work as I imagined, as the target URL for these single character links would still need to be encoded somewhere as part of the message.]

On the web, and in applications, URLs shouldn’t need to be minimised at all. Twitter clients could truncate URLs for display, but all the URL content should stay available to be used by those clients that want it.

Twitter has really taken off in the last few weeks. If you haven’t signed up yet, and are sick of hearing about it, I sympathise. I didn’t understand what the point was at all until I signed up, originally just so that I could follow a few interesting people better than I could using RSS. Eventually, you’ll see a conversation going on and want to join in.

From a web architecture point of view, Twitter is particularly interesting because it is, to my memory, the first web 2.0-ey application that doesn’t really need a website. They’ve done such a great job with their API and backend that there are dozens of excellent applications and plugins for just about every publishing platform. I read and post from a bunch of applications — Tweetie on my iPhone, and Lounge and Tweetdeck on my laptop — and very rarely actually visit the Twitter website.

I guess this is a matter of partly good timing (now that smartphones are common), and partly that tweets are perfect iPhone-sized data.

Recent bookmarks tagged with “api”.

Documentation and reference - Daft.ie API documentation
Emptees - API

What can I do with the API? We've provided you with this API so that you can build cool stuff with the content on Emptees. This could be anything from a dashboard widget showing the Tee of the Day, a MySpace or Facebook application, or showing off your tee portfolio on your personal website or blog. I'm sure you can think of much cooler things too.

iOS 4 adds direct access to iTunes library, iPhone DJ apps about to get crazy -- Engadget
Simple UK Train Times App – Still Dead and I’m Not Supposed to Talk About It | mockyblog
National Rail Have Killed My UK Train Times App | mockyblog
Hacker News | TfL Kill Two of My Apps
TfL Kill Two of My Apps | Malcolm Barclay

On Monday 18th Oct TfL turned off their journey planner XML API. I have been using this successfully for more than 6 months for both London Bus (now called London Travel Deluxe) and London Tube Deluxe Pro for iPad. TfL are well aware of the success & reach my applications have achieved; sometimes I’ll even get a friendly heads up as to status changes coming up to ensure things keep running smoothly (99.98% uptime).

Google Code Labs - Google Code

What does it mean to have a "3-year deprecation policy"? A 3-year deprecation policy means that we'll support each version of the API for at least 3 years from when it's deprecated or a newer version is introduced. For example, let's say an API is on v1 and then it launches v2 on March 1st, 2009. That means, that v1 will continue to be supported until March 1st, 2012. Similarly, if one day we announced that the API were being deprecated entirely, its most recent version would continue to be supported for 3 years from that date. For the full details on the deprecation policy, please refer to the products' terms of service.

User Streams | dev.twitter.com

User Streams provides real-time updates of all data needed to update a desktop application display. Applications can request startup back-fill from the REST API and then transition to Streaming for nearly all subsequent reads. Rate limits and latency are practically eliminated. Desktop developers can stop managing rate limits and use this new data to create an entirely new user experience. On our end, we hope to reduce costs and increase site reliability.

Alex Payne — The Very Last Thing I'll Write About Twitter

While Twitter has been growing in mainstream significance and popularity, it hasn’t managed to adopt a strategy that clearly aims the company towards mass market success. I think #newtwitter changes that, turning the site into a rich information discovery platform, if you’ll excuse the buzzword bingo. The new design is a pleasure to use, and encourages a kind of deep exploration of the data within Twitter that has previously only been exposed in bits and pieces by third-party applications. Browsing Twitter is now as rewarding as communicating with it.