Salesforce B2C Commerce 24.7 > Open Commerce API 23.2 > Shop API resources 23.2

Folders resource (Shop API 23.2)

Summary

Http Method	Resource	Description
GET	/folders/({id},...,{id})	To access one or more content folder, you construct a URL using the template shown below. This template requires you to specify one or more content folder ids and a subfolder level. In response, the server returns a result set of corresponding content folder documents. Only content folder, which are marked as online are returned.
GET	/folders/{id}	To access a content folder, you construct a URL using the template shown below. This template requires you to specify a content folder id and a subfolder level. In response, the server returns a corresponding content folder document. Only content folder, which are marked as online are returned.

Get multiple content folders

To access one or more content folder, you construct a URL using the template shown below. This template requires you to specify one or more content folder ids and a subfolder level. In response, the server returns a result set of corresponding content folder documents. Only content folder, which are marked as online are returned.

Url

GET http://hostname:port/dw/shop/v23_2/folders/({id},...,{id})?levels={Integer}&locale={String}

Formats

json, xml

Authentication

Name	Description
JWT	Authentication via Customer JWT.
None	No authentication.

Response Document

ContentFolderResult

Path Parameters

Parameter	Type	Description	Constraints
ids	[String]	The ids of the requested content folders.	maxItems=50, maxLength=256

Query Parameters

Parameter	Type	Description	Constraints
levels	Integer	Specifies how many levels of nested subfolders you want the server to return. The default value is 1. Valid values are 0, 1, or 2.	maxIntegerValue=2, minIntegerValue=0
locale	String	The locale context.

Customization

This Resource supports server-side customization.

Extension Point	Method Detail
dw.ocapi.shop.folder.beforeGET	beforeGET (id : String ) : Status The function is called before the request will be processed. Parameters: id - The id of the requested content folder. Returns: a non-null Status ends the hook execution
dw.ocapi.shop.folder.modifyGETResponse	modifyGETResponse (scriptFolder : Folder , doc : ContentFolder ) : Status The function is called after the request has been processed. Parameters: scriptFolder - an instance of dw.content.Folder doc - the document Returns: a non-null Status ends the hook execution

Extension Point

Method Detail

dw.ocapi.shop.folder.beforeGET

beforeGET (id : String ) : Status

The function is called before the request will be processed.

Parameters:: id - The id of the requested content folder.
Returns:: a non-null Status ends the hook execution

dw.ocapi.shop.folder.modifyGETResponse

modifyGETResponse (scriptFolder : Folder , doc : ContentFolder ) : Status

The function is called after the request has been processed.

Parameters:: scriptFolder - an instance of dw.content.Folder; doc - the document
Returns:: a non-null Status ends the hook execution

Sample

REQUEST:
GET /dw/shop/v23_2/folders/(our-story,our-team)?levels=0 HTTP/1.1
Host: example.com
Accept: application/json

RESPONSE:
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Cache-Control: max-age=900,must-revalidate
{
  "_v" : "23.2",
  "_type":"content_folder_result",
  "count":2,
  "total":2,
  "data":
  [
    {
      "id" : "our-story",
      "name" : "Our Story",
      "parent_folder_id" : "about-us"
    },
    {
      "id" : "our-team",
      "name" : "Our Team",
      "parent_folder_id" : "about-us"
    }
  ]
}

Get content folder

To access a content folder, you construct a URL using the template shown below. This template requires you to specify a content folder id and a subfolder level. In response, the server returns a corresponding content folder document. Only content folder, which are marked as online are returned.

Url

GET http://hostname:port/dw/shop/v23_2/folders/{id}?levels={Integer}&locale={String}