This work is licensed under a CC |
Atom is a read-only format for publishing entries and entry metadata in a feed. The Atom Publishing Protocol (AtomPub) is built on top of Atom for providing a protocol for submitting new entries to feeds. AtomPub introduces the concept of a collection, which is the set of entries which are managed through AtomPub and can be published as an Atom feed. AtomPub clients can add new entries to a collection using HTTP interactions, and AtomPub supports entries which are based on some XML format, as well as any other type of entry (such as images).
CUDout of the
CRUDset of operations
POST /edit/ HTTP/1.1 Host: media.example.org Content-Type: image/png Slug: The Beach Content-Length: nnn ...binary data...
HTTP/1.1 201 Created Date: Fri, 7 Oct 2005 17:17:11 GMT Content-Length: nnn Content-Type: application/atom+xml;type=entry;charset="utf-8" Location: http://example.org/media/edit/the_beach.atom <?xml version="1.0"?> <entry xmlns="http://www.w3.org/2005/Atom"> <title>The Beach</title> <id>urn:uuid:1225c695-cfb8-4ebb-aaaa-80da344efa6a</id> <updated>2005-10-07T17:17:08Z</updated> <author><name>Daffy</name></author> <content type="image/png" src="http://media.example.org/the_beach.png"/> <link rel="edit-media" href="http://media.example.org/edit/the_beach.png" /> <link rel="edit" href="http://example.org/media/edit/the_beach.atom" /> </entry>
Resource | HTTP Method | Representation | Description |
---|---|---|---|
Introspection | GET | Atom Service Document | Enumerates a set of collections and lists their URIs and other information about the collections |
Collection | GET | Atom Feed | A list of member of the collection (this may be a subset of all entries in the collection) |
Collection | POST | Atom Entry | Create a new entry in the collection |
Member | GET | Atom Entry | Get the Atom Entry |
Member | PUT | Atom Entry | Update the Atom Entry |
Member | DELETE | n/a | Delete the Atom Entry from the collection |
Service Documents represent server-defined groups of Collections, and are used to initialize the process of creating and editing resources.
realtop-level construct of AtomPub is the workspace
entry
as special value)fixed
)modules
http://www.example.com/feeds/jo/-/Fritz
http://www.example.com/feeds/jo/-/Fritz/Laurie
http://www.example.com/feeds/jo/-/Fritz%7CLaurie
http://www.example.com/feeds/jo/-/Fritz/-Laurie