Think of this website as a tutorial / guide to the Atom Publishing Protocol. You can use the menu on the left to dive into the tutorial, find resources / references, or contact me with questions and improvements.
Just so you can get a feel for what this guide is about below shows a very simple Atom Entry being posted to a URI. The header is highlighted and the sample Atom Entry is shown in its entirety. More colors will show later in the tutorial to depict Required, Optional, and Ignored Atom Entry elements.
POST /url/entries HTTP/1.1 Host: example.org User-Agent: SomeAgent/1.0 Content-Type: application/atom+xml Content-Length: nnn <?xml version="1.0" ?> <entry xmlns="http://www.w3.org/2005/Atom"> <title>Atom-Powered Robots Run Amok</title> <id>urn:uuid:1225c695-cfb8-4ebb-aaaa-80da344efa6a</id> <updated>2003-12-13T18:30:02Z</updated> <author><name>John Doe</name></author> <content>Some text.</content> </entry>
One of the most key elements for a Visual guide is use of color. I am going to try to relate color and purpose in the code samples that I provide. This way when you see a certain tag or section of text in a certain color you know will immediatly know the most critical information about how, when, and where to use that data. Here is the list of colors:
Header - Browser Requests and Server Responses Required - Entry Elements Required for Inserts or Updates Optional - Entry Elements that are Optional for Inserts or Updates Ignored - Entry Elements that can be ignored by the Atom server