Skip to main content

 Services

Web services from /about to /webhooks

get toc public

/groups/{group}/uris/{uri}/toc [GET]

Description

Output the partial TOC for a public publication including a content document (request URI marked by @content="true") and its ancestors.

If publicationid is not specified, then the publications for this document (that the current user can access) are ordered alphabetically by display title (then by ID) and the first publication is used.

Parameters

NameDescriptionRequiredTypeDefault value
publicationidThe publication ID for the TOC, empty mean standalone.nopublicationid
loadallWhether to output the entire TOCnobooleanfalse
versionThe publication versionnostring

Permission

This service is restricted to guest and higher unless the group is accessible to public.

Response

<toc>
  ...
  [<publication ...>]
    <publication-tree uriid="55593" title="System Report 2">
      <part level="1">
        <document-ref level="0" 
                      title="Requirements"
                      documenttype="references" 
                      uriid="55594" 
                      position="1" 
                      numbered="true"
                      prefix="1." 
                      canonical="1." 
                      children="true" />
        <part level="2" content="true">
          <document-ref level="0" 
                        title="Functionality"
                        documenttype="default" 
                        uriid="55578" 
                        position="1" 
                        numbered="true"
                        prefix="1.1" 
                        canonical="1.1." 
                        children="true" />
          <part level="3" uriid="55578">
            <heading-ref level="2"
                         title="Account" 
                         fragment="1-2"
                         index="1" 
                         numbered="true" 
                         prefix="1.1.1" 
                         canonical="1.1.1." />
            <transclusion uriid="65579" fragment="default" position="1" />
          </part>
          <part level="3" uriid="55578">
            <heading-ref level="2"
                         title="Equations"
                         fragment="1-2"
                         index="2"
                         numbered="true"
                         prefix="1.1.2"
                         canonical="1.1.2." />
          </part>
        </part>
        <part level="2">
          <document-ref level="0"
                        title="Extras"
                        documenttype="indent" 
                        uriid="55595" 
                        position="1" 
                        numbered="true"
                        prefix="1.2" 
                        canonical="1.2." />
        </part>
      </part>
      <part level="1">
        <document-ref level="0" 
                      title="Bibliography"
                      documenttype="bibliography" 
                      uriid="61110" 
                      position="1" />
      </part>
    </publication-tree>
  [</publication>
  <publication .../>]
  ...
</toc>

Error Handling

No specific errors expected for this service.

Created on , last edited on