I've sketched out the API in a markdown document you can view online
(
http://videoscrobbler.heroku.com/api/docs) there's also a PDF
flowchart of what I envisage scrobblers will be doing (http://
videoscrobbler.heroku.com/docs/scrobbler_layout.pdf)
The aim of the API is to allow people to keep track of what they're
watching, akin to
last.fm's audio scrobbling.
I'm using it pretty effectively with my setup (using Quicktime Player
X with metadata tagged videos) with the demo scrobbler I built for
myself (
http://gist.github.com/503240) you can see what I've been
watching (in crappy HTML) here:
http://videoscrobbler.heroku.com/users/jphastings
Let me know if you have any thoughts on the API itself an how I've
laid it out (it's roughly based on
last.fm's v2 api, if you hadn't
noticed, but there are some big changes).
DISCLAIMER: I know basically bugger all about The Way to code. All of
this is trial and error, so if you like the idea but know the
implementation is crappy, help make it better!