Version User Scope of changes
Jun 2 2008, 3:08 PM EDT cpatni 1 word added, 1 word deleted
May 16 2008, 1:54 PM EDT phattchumpy 11 words added

Changes

Key:  Additions   Deletions

HTTP MethodReturns
GETThe navigation structure for the specified cell.

Overview: Retrieves the navigation structure for the given cell. The default output for this request is a series of nested HTML unordered lists (UL's), but the HTML is probably NOT suitable for a server-side include.

The preferred way to use this request is to specify output=api on the query string. The api output format returns an xml document containing a hierarchy of cell elements that represent the requested cell's navigation structure.

The returned hierarchy starts with the requested cell's ancestral root cell, and contains all cells down to the requested cell, the requested cell itself, the cell's siblings, and the cell's immediate children. It also includes child counts for all cells ( the counts can be useful for generating custom navigation widgets, especially ones that use disclosure arrows ).
Common Parameters
plus...

Required Parameters:
output=api
Inform the service that you would like an XML response.

cell.cellId
The cell whose navigation structure to find.


Example Request ( required parameters in red ):

http://wapi.wetpaint.com/CellService/getCellChildren.dohttp://wapi.wetpaint.com/CellService/getNavigation.do
?key=yourissueddeveloperkey
&ns=yourassignednamespace
&cell.cellId=Real+Fame
&output=api

Example Response
  • requested cell's element = red
  • requested cell's children = blue
  • requested cell's siblings = orange
  • requested cell's ancestors up to root cell = purple

<response>
<cell>
<cellId>All About LeBron James</cellId>
<children total="7">
<cell>
<cellId>LeBron Bio</cellId>
<children total="3">
<cell>
<cellId>Real Fame</cellId>
<children total="3">
<cell>
<cellId>Blowing Up</cellId>
<children total="0" />
</cell>
<cell>
<cellId>Big Time</cellId>
<children total="2" />
</cell>
<cell>
<cellId>Fifteen Minutes</cellId>
<children total="1" />
</cell>
</children>
</cell>
<cell>
<cellId>Fan Q & A</cellId>
<children total="3" />
</cell>
<cell>
<cellId>Photo Gallery</cellId>
<children total="0" />
</cell>
</children>
</cell>
</children>
</cell>
</response>