Skip to main content Link Menu Expand (external link) Document Search Copy Copied

Module: Mage_Catalog

The Mage_Catalog module allows you to manage categories and products.

Resource Name: catalog_category

Aliases:

  • category
Method:
  • catalog_category.level (SOAP V1)
  • catalogCategoryLevel (SOAP V2)

Allows you to retrieve one level of categories by a website, a store view, or a parent category.

Aliases:

  • category.level

Arguments:

TypeNameDescription
stringsessionIdSession ID
stringwebsiteWebsite ID or code (optional)
stringstoreViewStore view ID or code (optional)
stringparentCategoryParent category ID (optional)

Returns:

TypeNameDescription
arraytreeArray of CatalogCategoryEntitiesNoChildren

The CatalogCategoryEntitityNoChildren content is as follows:

TypeNameDescription
intcategory_idCategory ID
intparent_idParent category ID
stringnameCategory name
intis_activeDefines whether the category is active
intpositionCategory position
intlevelCategory level

Examples

Request Example SOAP V1
$client = new SoapClient('http://magentohost/api/soap/?wsdl');

// If somestuff requires API authentication,
// then get a session token
$session = $client->login('apiUser', 'apiKey');

$result = $client->call($session, 'catalog_category.level');
var_dump($result);

// If you don't need the session anymore
//$client->endSession($session);
Request Example SOAP V2
$proxy = new SoapClient('http://magentohost/api/v2_soap/?wsdl'); // TODO : change url
$sessionId = $proxy->login('apiUser', 'apiKey'); // TODO : change login and pwd if necessary
 
$result = $proxy->catalogCategoryLevel($sessionId);
var_dump($result);
Response Example SOAP V1
array
  0 =>
    array
      'category_id' => string '2' (length=1)
      'parent_id' => int 1
      'name' => string 'Default Category' (length=16)
      'is_active' => string '1' (length=1)
      'position' => string '1' (length=1)
      'level' => string '1' (length=1)
  1 =>
    array
      'category_id' => string '3' (length=1)
      'parent_id' => int 1
      'name' => string 'root_category' (length=13)
      'is_active' => string '1' (length=1)
      'position' => string '2' (length=1)
      'level' => string '1' (length=1)