Get Started
No matter what your client program's purpose, the first thing it
must always do is send an HTTP GET
request to the web
service's "start" URL:
curl -u user:password -X GET http://host-ip-address/webservice/escenic/section/ROOT/subsections
It must then parse the Atom feed returned by the web service and extract the URLs it needs:
<feed xmlns="http://www.w3.org/2005/Atom"> <author> <name>Escenic Content Engine</name> </author> <id>http://host-ip-address/webservice/escenic/section/ROOT/subsections</id> <link rel="self" href="http://host-ip-address/webservice/escenic/section/ROOT/subsections" type="application/atom+xml"/> <updated>2010-06-23T16:51:06.721Z</updated> <title type="text">Publication root sections you are authorized to.</title> <link rel="changelog" href="http://host-ip-address/webservice/escenic/changelog" type="application/atom+xml"/> <entry> <id>http://host-ip-address/webservice/escenic/section/1</id> <title type="text">frontpage</title> <updated>2010-06-22T10:16:46.309Z</updated> <category term="directory" scheme="http://www.escenic.com/types"/> <link rel="edit-media" type="application/vnd.escenic.content+xml;type=com.escenic.section" href="http://host-ip-address/webservice/escenic/section/1"/> <link rel="down" href="http://host-ip-address/webservice/escenic/section/1/subsections" type="application/atom+xml"/> <link rel="http://www.escenic.com/types/relation/inboxes" href="http://host-ip-address/webservice/escenic/section/1/inboxes" type="application/atom+xml"/> <link rel="http://www.escenic.com/types/relation/lists" href="http://host-ip-address/webservice/escenic/section/1/lists" type="application/atom+xml"/> <link rel="http://www.escenic.com/types/relation/pages" href="http://host-ip-address/webservice/escenic/section/1/pages" type="application/atom+xml"/> <link rel="http://www.escenic.com/types/relation/content-items" href="http://host-ip-address/webservice/escenic/section/1/content-items" type="application/atom+xml"/> <link rel="http://www.escenic.com/types/relation/changelog" href="http://host-ip-address/webservice/escenic/changelog/section/1" type="application/atom+xml"/> </entry> </feed>
Each entry represents the root section of a publication, and the links in each entry represent the operations available for that publication. (There is only one entry in the example feed above: this means that the user submitting the request only has access to one publication at this installation.)