Dave likes Twitter. The Twitter API is proven itself and lessons have been learned. Lots of people know it. So my comments below reflect my usage of the Twitter API, particularly the search API.
- Categories. RSS has always supported categories and I was rather suprised not to see them in the API. Much of web 2.0 worked leveraged categoris and I think it is an important addition.
- RESTful. Several people have commented on using the RESTful verbs.
I certainly support that for GET and POST but since DELETE and PUT are
harder to implement there should be more discussion of that.
- Extending Really Simple. RSS supports namespaces and there should be someway to extend the Really Simple api. Steve Moyer commented about having extra fields like _rev in the API. In my view, extra fields would be fine but probably ignored by most clients. It would probably be better to suppress them, but in some implementations there are cases were the extra fields would add a feature. More discussion needed.
- getPost. Given an idPost, I would want to get the JSON for just that post. The id could be the permalink. And perhaps, maybe I supply a link and get back an array of posts which could be all of the comments made to a post.
- Enclosure. Very encouraged to see it supported. Important in this world of videos, photo blogs and other media files.
- OAuth. Twitter and others have moved away from basic authentication for a reason. I would suggest supporting OAuth like twitter.
- No date. The format of title, description and link is so powerful
that it applies to more than just reverse chronological blogs. The web
content management system (CMS) that I wrote had RSS feeds as its
foundation. [I'll have to add the ReallySimple API to it.] And see
example of Wikipedia below. However, I would think that this might be an
expected field. Or perhaps it is better to ignore it for right now
given the discussion that will start about date format.
I look forward to using the ReallySimple API with mobile apps and Couchdb apps.
Cross posted from: http://raydaly.posterous.com/really-simple-api-first-comments