Documentation: smugmug.users.getTree

luke_church

Issue: The documentation implies that the same structures are used for albums as in other methods, however different parameters are actually returned in the XML from XML-RPC 1.1.1

From Documentation: http://www.smugmug.com/hack/method-smugmug.users.getTree

Array of structs: (Albums, if present)

• struct: (Album Info, if Heavy set)

This is slightly ambiguous, however I took it to mean, return album as smugmug.albums.get or smugmug.albums.getInfo if heavy was set.

However, this is not the case, as smugmug.albums.get always contains a CategoryID, smugmug.users.getTree does not, (currently only tested without the heavy parameter).

Whilst this information is superfluous, it's absence may break an XML-RPC parser, unless it is marked as optional.

This is also related to the bug: http://www.dgrin.com/showthread.php?t=19420

Sample XML response:

[php]


<params>
<param>
<value>
<array>
<data>
<value>
<struct>
<member>
<name>CategoryID</name>
<value>
<int>0</int>
</value>
</member>
<member>
<name>Title</name>
<value>
<string>Other</string>
</value>
</member>
<member>
<name/>
<value>
<struct>
<member>
<name>SubCategoryID</name>
<value>
<int>111083</int>
</value>
</member>
<member>
<name>Title</name>
<value>
<string>ImagesTest</string>
</value>
</member>
<member>
<name/>
<value>
<struct>
<member>
<name>AlbumID</name>
<value>
<string>804780</string>
</value>
</member>
<member>
<name>Title</name>
<value>
<string>DeleteTest</string>
</value>
</member>
</struct>


[/php]