smugmug.subcategories.get

Retrieves a list of subcategories within a specified category for a given user.

Arguments

string SessionID
integer CategoryID
string NickName (optional)
string SitePassword (optional)

Result

array SubCategories
- struct SubCategory
  - string id
  - string Title

Note: From API version 1.2.1 onwards, to resolve naming inconsistencies the "Title" parameter has been renamed to "Name".

Fault Codes

3 - "invalid session"
4 - "invalid user"
15 - "empty set - no subcategories found"

Sample Responses

REST

<rsp stat="ok">
  <method>smugmug.subcategories.get</method>
  <SubCategories>
    <SubCategory id="227" Title="2005 Photos"/>
    <SubCategory id="500" Title="2006 Photos"/>
    <SubCategory id="843" Title="2007 Photos"/>
  </SubCategories>
</rsp>

JSON

{
  "stat":"ok",
  "method":"smugmug.subcategories.get",
  "Categories":[
    {"id":227,"Title":"2005 Photos"},
    {"id":500,"Title":"2006 Photos"},
    {"id":843,"Title":"2007 Photos"},
  ]
}

PHP

a:3:{
  s:4:"stat";s:2:"ok";
  s:6:"method";s:25:"smugmug.subcategories.get";
  s:10:"Categories";a:3:{
    i:0;a:2:{s:2:"id";i:227;s:5:"Title";s:11:"2005 Photos";}
    i:1;a:2:{s:2:"id";i:500;s:5:"Title";s:11:"2006 Photos";}
    i:2;a:2:{s:2:"id";i:843;s:5:"Title";s:11:"2007 Photos";}
  }
}

Page Operations

Browse Space