General Overview
The AOL Journals - Open Blog API is an implementation of the Atom Publishing Protocol (APP). The API allows for full creation, deletion, retrieval, and updates of blogs, entries, and comments. It is integrated with the RSS/Atom feed services provided by the blog platform.
Developers who use the AOL Journals - Open Blog API will gain many benefits for both Feed Readers and applications using a simple, standards-based HTTP REST-style interface, requiring you to just formulate HTTP requests and parse XML responses. For Feed Readers, the API provides a more complete, flexible and powerful feed mechanism than RSS. For applications, it provides the capability of putting a different face on AOL blogs and it also provides the capability for an application to add and modify AOL blogs, entries and comments.
Features
We started our API by supporting the "basic" use of Atom from feed readers. From there, we expanded its use as a general tool for viewing and manipulating blogs, so that you can now do most of the things that you can do from the AOL Journals UI through our AOL Journals - Open Blog API. This includes functionality such as:
- Getting all the blogs for a user
- Reading a blog, with entries
- Updating much of the blog information
- Reading, writing and updating individual blog entries
- Reading, adding and deleting comments on a blog entry
We have done so using a simple, standards-based HTTP REST interface, requiring you to just formulate HTTP requests and parse XML responses.
The Atom standard provided a framework for accomplishing all these actions, so we have stuck close to those standards. Details about Atom itself are outside the scope of this "Getting Started" document. Look at the main API document for details on that interaction.
What's New
AOL Journals CFC Sneak Peek
Blog Entry by Brice Mason
December 14, 2007
Last week I demonstrated some of the advanced capabilities of the AOL Journals API by integrating the features of AOL Open Authentication. Today we'll take it a step further by creating a fully capable CFC to add to the AOL API CFC project. The code we wrote last week was functional and intuitive, however it became very clear early on in the demonstration how useful it would be to consolidate code into their own functions. We probably wrote well under 100 lines of code and covered much of the API's capability but now we have the chance to really lighten up our code.
Introducing the AOL Journals Open Blog APIby Kevin Farnham
November 29, 2007
The AOL Journals Open Blog API provides a REST-style interface for retrieving, updating, creating, and deleting a user's AOL Journals blog resources. The Open Blog API is based on the Atom Publishing Protocol. The API is integrated with the RSS capability of the AOL Journals platform. To use the API, the client submits HTTP requests, and it receives responses in XML format.
On The Horizon
AOL Journals - Open Blog API Data Sheet
October 2 2007
Atom Feed Request
As mentioned above, we started by supporting Atom feed requests, so let's start our examples from here also. A feed request is a request to get the information about a blog and the recent entries for that blog. This is normally done by merely appending /atom.xml onto the resource you want to get a feed from. So, for example, for blog http://blogs.aol.com/bsteinback0224/counter you just do an HTTP GET of: http://api.blogs.aol.com/bsteinback0224/counter/atom.xml
