Retrieve Content Item History
Client applications can retrieve an Atom feed containing the edit history of a content item. The history feed contains an entry for each modification made to the content item. An entry in the feed contains the time a change was made, the name of the user who made the change and information about any state change applied to the content item.
If content item staging is enabled, then once a content item is published, any changes made to the draft copy of the content item are not recorded in the history. An entry is only add to the history feed if such changes are published.
A link to an edit history feed is included in every content item's Atom entry resource:
<entry> ... <link href="http://host-ip-address/webservice/escenic/content/1337/log" rel="http://www.vizrt.com/types/relation/log"/> ... </entry>
A client can retrieve the history feed by following the link, for example:
curl -u user:password -X GET http://host-ip-address/webservice/escenic/content/1337/log
This will return something like:
<feed xmlns="http://www.w3.org/2005/Atom"> <author> <name>Escenic Content Engine</name> </author> <id>http://host-ip-address:8080/webservice/escenic/content/1337/log</id> <link rel="self" href="http://host-ip-address:8080/webservice/escenic/content/1337/log" type="application/atom+xml"/> <updated>2012-12-05T08:34:53.041Z</updated> <title type="text">Article log</title> <link rel="next" href="http://host-ip-address:8080/webservice/escenic/content/1337/log/after/2846?count=10"/> <link rel="previous" href="http://host-ip-address:8080/webservice/escenic/content/1337/log/before/2870?count=10"/> <entry> <updated>2012-11-29T12:33:16.000Z</updated> <author>John Doe</author> </entry> <entry> <updated>2012-11-29T12:32:48.000Z</updated> <app:control xmlns:app="http://www.w3.org/2007/app" xmlns:vaext="http://www.vizrt.com/atom-ext"> <app:draft>yes</app:draft> <vaext:state>submitted</vaext:state> </app:control> <author>John Doe</author> </entry> <entry> <updated>2012-11-26T09:35:27.000Z</updated> <author>John Doe</author> </entry> <entry> <updated>2012-11-26T09:35:17.000Z</updated> <author></author> </entry> </feed>
The edit history is returned as an Atom paged collection. The first
entry in the first Atom feed returned represents the most recent change
to the content item. The next entry represents the second most recent
change, and so on. If there is more than one page of entries, then you
can retrieve the next page by following this feed's
next
link.
An entry with an empty author
field represents a
change made by an automated process such as the syndication module or
a background service.