Retrieve a Section

The Atom feeds returned when navigating a publication's section tree, as described in Navigate The Section Hierarchy, contain entries for all the subsections of a section. In addition to navigation links, each of these entries has a content element that contains the actual section definition. For example:

<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  ...[elements omitted]...
  <title type="text">Subsections for Section with id=1</title>
  <entry xmlns:app="http://www.w3.org/2007/app" 
         xmlns:metadata="http://xmlns.escenic.com/2010/atom-metadata" xmlns:dcterms="http://purl.org/dc/terms/">
    <id>http://host-ip-address/webservice/escenic/section/2</id>
    <link rel="self" href="http://host-ip-address/webservice/escenic/section/2" type="application/atom+xml; type=entry"/>
    <link rel="edit" href="http://host-ip-address/webservice/escenic/section/2" type="application/atom+xml; type=entry"/>
    <link rel="http://www.vizrt.com/types/relation/lock" href="http://host-ip-address/webservice/escenic/lock/section/2" 
          type="application/atom+xml; type=entry"/>
    <dcterms:identifier>2</dcterms:identifier>
    <link href="http://host-ip-address/webservice/escenic/publication/publication-id/" 
          rel="http://www.vizrt.com/types/relation/publication" type="application/atom+xml; type=entry" title="demo"/>
    <metadata:publication href="http://host-ip-address/webservice/escenic/publication/publication-id/" title="publication-title"/>
    <content type="application/vnd.vizrt.payload+xml">
      <vdf:payload xmlns:vdf="http://www.vizrt.com/types" 
                   model="http://host-ip-address/webservice/escenic/publication/publication-id/model/com.escenic.section">
        <vdf:field name="com.escenic.sectionName">
          <vdf:value>New Articles</vdf:value>
        </vdf:field>
        <vdf:field name="com.escenic.uniqueName">
          <vdf:value>ece_incoming</vdf:value>
        </vdf:field>
        <vdf:field name="com.escenic.directoryName">
          <vdf:value>incoming</vdf:value>
        </vdf:field>
        <vdf:field name="com.escenic.sectionURI"/>
        <vdf:field name="com.escenic.inheritAccess">
          <vdf:value>true</vdf:value>
        </vdf:field>
        <vdf:field name="com.escenic.virtualSource">
          <vdf:value>false</vdf:value>
        </vdf:field>
        <vdf:field name="com.escenic.hidden">
          <vdf:value>false</vdf:value>
        </vdf:field>
        <vdf:field name="com.escenic.agreementRequired">
          <vdf:value>false</vdf:value>
        </vdf:field>
        <vdf:field name="com.escenic.agreementInfo"/>
        <vdf:field name="com.escenic.agreementType"/>
        <vdf:field name="com.escenic.sectionLayout">
          <vdf:value>defaultsection</vdf:value>
        </vdf:field>
        <vdf:field name="com.escenic.articleLayout">
          <vdf:value>defaultarticle</vdf:value>
        </vdf:field>
        <vdf:field name="com.escenic.sectionParameters">
          <vdf:value/>
        </vdf:field>
      </vdf:payload>
    </content>
    ...[elements omitted]...
  </entry>
  ...[other entry elements omitted]...
</feed>

Therefore, you probably don't need to explicitly retrieve section objects. You can do so if you wish, by following the self or edit link in each of the feed's entries (highlighted above). For example:

curl -u user:password http://host-ip-address/webservice/escenic/section/3

However, all you will get by doing so is exactly the same content packaged as a single Atom entry:

<?xml version="1.0"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:app="http://www.w3.org/2007/app" xmlns:metadata="http://xmlns.escenic.com/2010/atom-metadata" xmlns:dcterms="http://purl.org/dc/terms/">
  <id>http://host-ip-address/webservice/escenic/section/3</id>
  <link rel="self" href="http://host-ip-address/webservice/escenic/section/3" type="application/atom+xml; type=entry"/>
  <link rel="edit" href="http://host-ip-address/webservice/escenic/section/3" type="application/atom+xml; type=entry"/>
  <link rel="http://www.vizrt.com/types/relation/lock" href="http://host-ip-address/webservice/escenic/lock/section/3" type="application/atom+xml; type=entry"/>
  <dcterms:identifier>3</dcterms:identifier>
  <link href="http://host-ip-address/webservice/escenic/publication/publication-id/" rel="http://www.vizrt.com/types/relation/publication" type="application/atom+xml; type=entry" title="demo"/>
  <metadata:publication href="http://host-ip-address/webservice/escenic/publication/publication-id/" title="publication-title"/>
  <content type="application/vnd.vizrt.payload+xml">
    <vdf:payload xmlns:vdf="http://www.vizrt.com/types" model="http://host-ip-address/webservice/escenic/publication/publication-id/model/com.escenic.section">
      <vdf:field name="com.escenic.sectionName">
        <vdf:value>Examples</vdf:value>
      </vdf:field>
      <vdf:field name="com.escenic.uniqueName">
        <vdf:value>ece_examples</vdf:value>
      </vdf:field>
      <vdf:field name="com.escenic.directoryName">
        <vdf:value>Examples</vdf:value>
      </vdf:field>
      <vdf:field name="com.escenic.sectionURI"/>
      <vdf:field name="com.escenic.inheritAccess">
        <vdf:value>true</vdf:value>
      </vdf:field>
      <vdf:field name="com.escenic.virtualSource">
        <vdf:value>false</vdf:value>
      </vdf:field>
      <vdf:field name="com.escenic.hidden">
        <vdf:value>false</vdf:value>
      </vdf:field>
      <vdf:field name="com.escenic.agreementRequired">
        <vdf:value>false</vdf:value>
      </vdf:field>
      <vdf:field name="com.escenic.agreementInfo"/>
      <vdf:field name="com.escenic.agreementType"/>
      <vdf:field name="com.escenic.sectionLayout">
        <vdf:value>defaultsection</vdf:value>
      </vdf:field>
      <vdf:field name="com.escenic.articleLayout">
        <vdf:value>defaultarticle</vdf:value>
      </vdf:field>
      <vdf:field name="com.escenic.sectionParameters">
        <vdf:value/>
      </vdf:field>
    </vdf:payload>
  </content>
  ...[elements omitted]...
</entry>