ProductLists Resource (Shop API 15.6)

Summary

Http Method Resource Description
GET /Product_lists Retrieves a list of all product lists as defined by the given search term (hence email, firstname, lastname). If no search term is given all owned product lists will be retrieved.
GET /Product_lists/{List_id} Retrieves a product list by id.
PATCH /Product_lists/{List_id} Changes a product list. Changeable properties are the name, description and if the list is public.
GET /Product_lists/{List_id}/Items Retrieves a product list's items.
POST /Product_lists/{List_id}/Items Adds a product to a product list.
PATCH /Product_lists/{List_id}/Items/{Item_id} Change an item of a product list. You can change the priority, quantity and if this item is public.
DELETE /Product_lists/{List_id}/Items/{Item_id} Deletes an item of a product list.

Get List of Product Lists

Retrieves a list of all product lists as defined by the given search term (hence email, firstname, lastname). If no search term is given all owned product lists will be retrieved.

Url

GET http://hostname:port/dw/shop/v15_6/product_lists?email={String}&firstname={String}&lastname={String}

Formats

json, xml

Authentication

Name Description
None No authentication.

Response Document

ProductListResult

Query Parameters

Parameter Type Description Constraints
email String email address of the customer, the product lists belong to  
firstname String first name of the customer, the product lists belong to  
lastname String last name of the customer, the product lists belong to  

In case of a failure Fault Document is returned.

Faults

Status Type Arguments Description
400 ProductListSearchTermException   Indicates that the anonymous customer did not provide a proper search term.
401 CustomerNotAuthenticatedException   Indicates that the customer is not authenticated and must be logged in.

Sample

REQUEST:
GET /dw/shop/v15_6/product_lists?firstname=john&lastname=doe HTTP/1.1
Host: example.com
Cookie: dwcustomer_9727b83e8e864fa4b6902a37bc70a12d=cdT3mHBc4s8q4y1bE9qaLNQIaW;
        dwsid=pATvWUO3KSdt-Kmcy-8-RsxKnoO4BMDwoec7ACVlW6tZNnhaOL7gt7mHqL-h7QYn5TyE61z0DeSMCqxngsWeHw==;
        dwsecuretoken_9727b83e8e864fa4b6902a37bc70a12d=5Kx5-2P7jj5WoxeTiWwHNBJ6QV39Io5SNA==;
        dwanonymous_9727b83e8e864fa4b6902a37bc70a12d=acwoUwjMGdrNan1VP6HmIghWOJ

RESPONSE:
Cache-Control:max-age=0,no-cache,no-store,must-revalidate
Keep-Alive:timeout=15, max=99
Connection:Keep-Alive
Content-Type:application/json;charset=UTF-8
Content-Length:483
{
   "_v" : "15.6",
   "count" : 2,
   "data" : 
   [
      
      {
         "link" : "https://example.com/s/SiteGenesis/dw/shop/v15_6/product_lists/cd2Id9aaabTQYaaadj9vRpVGwg",
         "name" : "DC-Doe-Wedding",
         "public" : false,
         "title" : "DC-Doe-Wedding",
         "type" : "gift_registry"
      },
      
      {
         "link" : "https://example.com/s/SiteGenesis/dw/shop/v15_6/product_lists/ghjMV9aaab9d2aaafjycppVGwe",
         "public" : false,
         "title" : "Wish List",
         "type" : "wish_list"
      }
   ],
   "total" : 2
}

Get Product List

Retrieves a product list by id.

Url

GET http://hostname:port/dw/shop/v15_6/product_lists/{list_id}

Formats

json, xml

Authentication

Name Description
None No authentication.

Response Document

ProductList

Path Parameters

Parameter Type Description Constraints
list_id String id of the list mandatory=true, maxLength=28, minLength=1, nullable=false

In case of a failure Fault Document is returned.

Faults

Status Type Arguments Description
401 CustomerNotAuthenticatedException   Indicates that the customer is not authenticated and must be logged in.
403 CustomerNotAuthorizedException   Indicates that the authenticated customer is not the owner of the list
404 ProductListNotFoundException

productListId (String)

 Indicates that this list doesn't exist

Sample

REQUEST:
GET /dw/shop/v15_6/product_lists/cdmeh9aaabqtwaaadjcLADJaTY HTTP/1.1
Host: example.com
Cookie: dwcustomer_9727b83e8e864fa4b6902a37bc70a12d=cdT3mHBc4s8q4y1bE9qaLNQIaW;
        dwsid=pATvWUO3KSdt-Kmcy-8-RsxKnoO4BMDwoec7ACVlW6tZNnhaOL7gt7mHqL-h7QYn5TyE61z0DeSMCqxngsWeHw==;

# in case of success:
 
RESPONSE:
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "co_registrant" : 
   {
      "email" : "[email protected]",
      "first_name" : "Jane",
      "last_name" : "Doe",
      "role" : "Bride"
   },
   "current_shipping_address_link" : 
   {
      "link" : "https://example.com/s/SiteGenesis/dw/shop/v15_6/account/this/addresses/me?client_id=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "title" : "me, John Doe, Woburn"
   },
   "event" : 
   {
      "city" : "Washington",
      "country" : "US",
      "date" : "2015-07-30T00:00Z",
      "state" : "DC",
      "type" : "Wedding"
   },
   "id" : "bcqg6iWbw4XEYaaadjixFLTWP0",
   "items_link" : 
   {
      "link" : "https://example.com/s/SiteGenesis/dw/shop/v15_6/product_lists/bcqg6iWbw4XEYaaadjixFLTWP0/items?client_id=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "title" : "2 items"
   },
   "name" : "DC-Doe-Wedding",
   "owner_link" : 
   {
      "link" : "https://example.com/s/SiteGenesis/dw/shop/v15_6/customers/[email protected]?client_id=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "title" : "John Doe"
   },
   "post_event_shipping_address_link" : 
   {
      "link" : "https://example.com/s/SiteGenesis/dw/shop/v15_6/account/this/addresses/jane?client_id=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "title" : "jane, Jane Doe, Springfield"
   },
   "public": false, 
   "registrant" : 
   {
      "email" : "[email protected]",
      "first_name" : "John",
      "last_name" : "Doe",
      "role" : "Groom"
   },
   "shipping_address_link" : 
   {
      "link" : "https://example.com/s/SiteGenesis/dw/shop/v15_6/account/this/addresses/me?client_id=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "title" : "me, John Doe, Woburn"
   },
   "type" : "gift_registry"
}

# in case of failure (authentication failed):
 
RESPONSE:
HTTP/1.1 401 Unauthorized
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "CustomerNotAuthenticatedException",
      "message" : "Customer must be authenticated."
   }
}

# in case of failure (authorization failed):
 
RESPONSE:
HTTP/1.1 403 Forbidden
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "CustomerNotAuthorizedException",
      "message" : "Customer is not authorized for this action."
   }
}

# in case of failure (list not found):
 
RESPONSE:
HTTP/1.1 404 Not Found
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "NotFoundException",
      "message" : "Productlist with id 'cdmeh9aaabqtwaaadjcLADJaTZ' not found."
   }
}

Change Product List

Changes a product list. Changeable properties are the name, description and if the list is public.

Url

PATCH http://hostname:port/dw/shop/v15_6/product_lists/{list_id}

Formats

json, xml

Authentication

Name Description
None No authentication.

Request Document

ProductList

Response Document

ProductList

Path Parameters

Parameter Type Description Constraints
list_id String id of the list mandatory=true, maxLength=28, minLength=1, nullable=false

In case of a failure Fault Document is returned.

Faults

Status Type Arguments Description
401 CustomerNotAuthenticatedException   Indicates that the customer is not authenticated and must be logged in.
403 CustomerNotAuthorizedException   Indicates that the authenticated customer is not the owner of the list
404 ProductListNotFoundException

productListId (String)

 Indicates that this list doesn't exist

Sample

REQUEST:
PATCH /dw/shop/v15_6/product_lists/cdmeh9aaabqtwaaadjcLADJaTY HTTP/1.1
Host: example.com
Content-Type: application/json; charset=UTF-8
Cookie: dwcustomer_9727b83e8e864fa4b6902a37bc70a12d=cdT3mHBc4s8q4y1bE9qaLNQIaW;
        dwsid=pATvWUO3KSdt-Kmcy-8-RsxKnoO4BMDwoec7ACVlW6tZNnhaOL7gt7mHqL-h7QYn5TyE61z0DeSMCqxngsWeHw==;
{
    "name":"MyWedding",
    "description":"wishlist for my wedding",
    "public":true
}

# in case of success

RESPONSE:
HTTP/1.1 200 OK
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "co_registrant" : 
   {
      "email" : "[email protected]",
      "first_name" : "Jane",
      "last_name" : "Doe",
      "role" : "Bride"
   },
   "current_shipping_address_link" : 
   {
      "link" : "https://example.com/s/SiteGenesis/dw/shop/v15_6/account/this/addresses/me?client_id=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "title" : "me, John Doe, Woburn"
   },
   "event" : 
   {
      "city" : "Washington",
      "country" : "US",
      "date" : "2015-07-30T00:00Z",
      "state" : "DC",
      "type" : "Wedding"
   },
   "id" : "cdmeh9aaabqtwaaadjcLADJaTY",
   "items_link" : 
   {
      "link" : "https://example.com/s/SiteGenesis/dw/shop/v15_6/product_lists/bcqg6iWbw4XEYaaadjixFLTWP0/items?client_id=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "title" : "2 items"
   },
   "name" : "MyWedding",
   "description" : "wishlist for my wedding",
   "post_event_shipping_address_link" : 
   {
      "link" : "https://example.com/s/SiteGenesis/dw/shop/v15_6/account/this/addresses/jane?client_id=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "title" : "jane, Jane Doe, Springfield"
   },
   "public": true, 
   "registrant" : 
   {
      "email" : "[email protected]",
      "first_name" : "John",
      "last_name" : "Doe",
      "role" : "Groom"
   },
   "shipping_address_link" : 
   {
      "link" : "https://example.com/s/SiteGenesis/dw/shop/v15_6/account/this/addresses/me?client_id=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "title" : "me, John Doe, Woburn"
   },
   "type" : "gift_registry"
}

# in case of failure (authentication failed):
 
RESPONSE:
HTTP/1.1 401 Unauthorized
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "CustomerNotAuthenticatedException",
      "message" : "Customer must be authenticated."
   }
}

# in case of failure (authorization failed):
 
RESPONSE:
HTTP/1.1 403 Forbidden
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "CustomerNotAuthorizedException",
      "message" : "Customer is not authorized for this action."
   }
}

# in case of failure (list not found):
 
RESPONSE:
HTTP/1.1 404 Not Found
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "NotFoundException",
      "message" : "Productlist with id 'cdmeh9aaabqtwaaadjcLADJaTY' not found."
   }
}

Get Product List Items

Retrieves a product list's items.

Url

GET http://hostname:port/dw/shop/v15_6/product_lists/{list_id}/items

Formats

json, xml

Authentication

Name Description
None No authentication.

Response Document

ProductListItemResult

Path Parameters

Parameter Type Description Constraints
list_id String id of the list mandatory=true, maxLength=28, minLength=1, nullable=false

In case of a failure Fault Document is returned.

Faults

Status Type Arguments Description
401 CustomerNotAuthenticatedException   Indicates that the customer is not authenticated and must be logged in.
403 CustomerNotAuthorizedException   Indicates that the authenticated customer is not the owner of the list
404 ProductListNotFoundException

productListId (String)

 Indicates that this list doesn't exist

Sample

REQUEST:
GET /dw/shop/v15_6/product_lists/cdmeh9aaabqtwaaadjcLADJaTY/items HTTP/1.1
Host: example.com
Content-Type: application/json; charset=UTF-8
Cookie: dwcustomer_9727b83e8e864fa4b6902a37bc70a12d=cdT3mHBc4s8q4y1bE9qaLNQIaW;
        dwsid=pATvWUO3KSdt-Kmcy-8-RsxKnoO4BMDwoec7ACVlW6tZNnhaOL7gt7mHqL-h7QYn5TyE61z0DeSMCqxngsWeHw==;

# in case of success:
 
RESPONSE:
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "count" : 2,
   "data" : 
   [
      
      {
         "id" : "cdPIB9aaabYFEaaadjOdBoMrMt",
         "position" : -1,
         "priority" : 2,
         "product_details_link" : 
         {
            "link" : "https://example.com/s/SiteGenesis/dw/shop/v15_6/products/008884303989?locale=en-US&client_id=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
            "product_id" : "008884303989",
            "product_name" : "Platinum Blue Stripes Easy Care Fitted Shirt",
            "title" : "Platinum Blue Stripes Easy Care Fitted Shirt"
         },
         "public" : true,
         "purchased_quantity" : 0,
         "quantity" : 10,
         "type" : "product"
      },
      
      {
         "id" : "cdH9N9aaabYFIaaadjOdBoMrMt",
         "position" : -1,
         "priority" : 2,
         "product_details_link" : 
         {
            "link" : "https://example.com/s/SiteGenesis/dw/shop/v15_6/products/008885535488?locale=en-US&client_id=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
            "product_id" : "008885535488",
            "product_name" : "Must Have Washable No-Iron Georgette Blouse",
            "title" : "Must Have Washable No-Iron Georgette Blouse"
         },
         "public" : true,
         "purchased_quantity" : 0,
         "quantity" : 1,
         "type" : "product"
      }
   ],
   "total" : 2
}

# in case of failure (authentication failed):
 
RESPONSE:
HTTP/1.1 401 Unauthorized
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "CustomerNotAuthenticatedException",
      "message" : "Customer must be authenticated."
   }
}

# in case of failure (authorization failed):
 
RESPONSE:
HTTP/1.1 403 Forbidden
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "CustomerNotAuthorizedException",
      "message" : "Customer is not authorized for this action."
   }
}

# in case of failure (list not found):
 
RESPONSE:
HTTP/1.1 404 Not Found
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "NotFoundException",
      "message" : "Productlist with id 'cdmeh9aaabqtwaaadjcLADJaTZ' not found."
   }
}

Add Product to Product List

Adds a product to a product list.

Url

POST http://hostname:port/dw/shop/v15_6/product_lists/{list_id}/items

Formats

json, xml

Authentication

Name Description
None No authentication.

Request Document

ProductListItem

Response Document

ProductListItem

Path Parameters

Parameter Type Description Constraints
list_id String id of the list mandatory=true, maxLength=28, minLength=1, nullable=false

In case of a failure Fault Document is returned.

Faults

Status Type Arguments Description
400 ProductListProductIdMissingException   Indicates that there was no product id given for the desired item.
400 ProductListItemTypeMissingException   Indicates that there was not item type given, which is required create a product item.
400 ProductListProductNotFoundException

productId (String)

 Indicates that there is no product existing for the given product id.
400 ProductListDuplicateGiftCertificateException   Indicates that the given gift certificate could not be added due to an existing one (there can be only one gift certificate per product list).
401 CustomerNotAuthenticatedException   Indicates that the customer is not authenticated and must be logged in.
403 CustomerNotAuthorizedException   Indicates that the authenticated customer is not the owner of the list
404 ProductListNotFoundException

productListId (String)

 Indicates that this list doesn't exist

Sample

#
# Example 1: add product
#
REQUEST:
POST /dw/shop/v15_6/product_lists/cdmeh9aaabqtwaaadjcLADJaTY/items HTTP/1.1
Host: example.com
Content-Type: application/json; charset=UTF-8
Cookie: dwcustomer_9727b83e8e864fa4b6902a37bc70a12d=cdT3mHBc4s8q4y1bE9qaLNQIaW;
        dwsid=pATvWUO3KSdt-Kmcy-8-RsxKnoO4BMDwoec7ACVlW6tZNnhaOL7gt7mHqL-h7QYn5TyE61z0DeSMCqxngsWeHw==;

{
    "type" : "product",
    "quantity" : 5,
    "priority" : 10,
    "public" : false,
    "product_details_link" :
    {
        "product_id" : "008884303989"
    }
}

# in case of success:
 
RESPONSE:
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "_type" : "product_list_item",
   "id" : "cdHYN9aaabZCEaaadj7dhW0d1L",
   "position" : -1,
   "priority" : 10,
   "product_details_link" : 
   {
      "_type" : "product_details_link",
      "link" : "https://example.com/s/SiteGenesis/dw/shop/v15_6/products/008884303989?client_id=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "product_id" : "008884303989",
      "product_name" : "Platinum Blue Stripes Easy Care Fitted Shirt",
      "title" : "Platinum Blue Stripes Easy Care Fitted Shirt"
   },
   "public" : false,
   "purchased_quantity" : 0,
   "quantity" : 5,
   "type" : "product"
}

# in case of failure (authentication failed):
 
RESPONSE:
HTTP/1.1 401 Unauthorized
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "CustomerNotAuthenticatedException",
      "message" : "Customer must be authenticated."
   }
}

# in case of failure (authorization failed):
 
RESPONSE:
HTTP/1.1 403 Forbidden
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "CustomerNotAuthorizedException",
      "message" : "Customer is not authorized for this action."
   }
}

# in case of failure (list not found):
 
RESPONSE:
HTTP/1.1 404 Not Found
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "NotFoundException",
      "message" : "Productlist with id 'cdmeh9aaabqtwaaadjcLADJaTZ' not found."
   }
}

# in case of failure (product id missing):
 
RESPONSE:
HTTP/1.1 404 Not Found
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "ProductListProductIdMissingException",
      "message" : "Product id missing."
   }
}

# in case of failure (product not found for given id):
 
RESPONSE:
HTTP/1.1 404 Not Found
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "ProductListProductNotFoundException",
      "message" : "Product with id '008884303987' not found."
   }
}

# in case of failure (product item type invalid):
 
RESPONSE:
HTTP/1.1 404 Not Found
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "ProductListInvalidItemTypeException",
      "message" : "Productlist item type '999' unknown."
   }
}

#
# Example 2: add gift certificate
#
REQUEST:
POST /dw/shop/v15_6/product_lists/cdmeh9aaabqtwaaadjcLADJaTY/items HTTP/1.1
Host: example.com
Content-Type: application/json; charset=UTF-8
Cookie: dwcustomer_9727b83e8e864fa4b6902a37bc70a12d=cdT3mHBc4s8q4y1bE9qaLNQIaW;
        dwsid=pATvWUO3KSdt-Kmcy-8-RsxKnoO4BMDwoec7ACVlW6tZNnhaOL7gt7mHqL-h7QYn5TyE61z0DeSMCqxngsWeHw==;

{
    "type" : "gift_certificate",
    "priority" : 10,
    "public" : false,
}

# in case of success:
 
RESPONSE:
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "_type" : "product_list_item",
   "id" : "ceOe79aaabcKgaaadjm3RW0d1T",
   "position" : -1,
   "priority" : 5,
   "public" : false,
   "purchased_quantity" : 0,
   "type" : "gift_certificate"
}

# in case of failure (list already contained a gift certificate when trying to add another one):
 
RESPONSE:
HTTP/1.1 404 Not Found
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "ProductListDuplicateGiftCertificateException",
      "message" : "Productlist already contains a gift certificate."
   }
}

Change Item of Product List

Change an item of a product list. You can change the priority, quantity and if this item is public.

Url

PATCH http://hostname:port/dw/shop/v15_6/product_lists/{list_id}/items/{item_id}

Formats

json, xml

Authentication

Name Description
None No authentication.

Request Document

ProductListItem

Response Document

ProductListItem

Path Parameters

Parameter Type Description Constraints
item_id String id of the item mandatory=true, maxLength=28, minLength=1, nullable=false
list_id String id of the list mandatory=true, maxLength=28, minLength=1, nullable=false

In case of a failure Fault Document is returned.

Faults

Status Type Arguments Description
401 CustomerNotAuthenticatedException   Indicates that the customer is not authenticated and must be logged in.
403 CustomerNotAuthorizedException   Indicates that the authenticated customer is not the owner of the list
404 ProductListNotFoundException

productListId (String)

 Indicates that this list doesn't exist
404 ProductListItemNotFoundException

itemId (String)

 Indicates that this item doesn't exist

Sample

REQUEST:
PATCH /dw/shop/v15_6/product_lists/cdmeh9aaabqtwaaadjcLADJaTY/items/egxlF9aaabd0kaaaejqgaDhv2c HTTP/1.1
Host: example.com
Content-Type: application/json; charset=UTF-8
Cookie: dwcustomer_9727b83e8e864fa4b6902a37bc70a12d=cdT3mHBc4s8q4y1bE9qaLNQIaW;
        dwsid=pATvWUO3KSdt-Kmcy-8-RsxKnoO4BMDwoec7ACVlW6tZNnhaOL7gt7mHqL-h7QYn5TyE61z0DeSMCqxngsWeHw==;
{
    "quantity":5,
    "priority":10,
    "public":false
}

# in case of success

RESPONSE:
HTTP/1.1 200 OK
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "_type" : "product_list_item",
   "id" : "egxlF9aaabd0kaaaejqgaDhv2c",
   "position" : -1,
   "priority" : 10,
   "product_details_link" : 
   {
      "_type" : "product_details_link",
      "link" : "https://example.com/s/SiteGenesis/dw/shop/v15_6/products/008884303989?client_id=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "product_id" : "008884303989",
      "product_name" : "Platinum Blue Stripes Easy Care Fitted Shirt",
      "title" : "Platinum Blue Stripes Easy Care Fitted Shirt"
   },
   "public" : false,
   "purchased_quantity" : 0,
   "quantity" : 5,
   "type" : "product"
}

# in case of failure (authentication failed):
 
RESPONSE:
HTTP/1.1 401 Unauthorized
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "CustomerNotAuthenticatedException",
      "message" : "Customer must be authenticated."
   }
}

# in case of failure (authorization failed):
 
RESPONSE:
HTTP/1.1 403 Forbidden
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "CustomerNotAuthorizedException",
      "message" : "Customer is not authorized for this action."
   }
}

# in case of failure (list not found):
 
RESPONSE:
HTTP/1.1 404 Not Found
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "NotFoundException",
      "message" : "Productlist with id 'cdmeh9aaabqtwaaadjcLADJaTY' not found."
   }
}


# in case of failure (item not found):
 
RESPONSE:
HTTP/1.1 404 Not Found
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "NotFoundException",
      "message" : "Productlist item with id 'egxlF9aaabd0kaaaejqgaDhv2c' not found."
   }
}

Delete Product from Product List

Deletes an item of a product list.

Url

DELETE http://hostname:port/dw/shop/v15_6/product_lists/{list_id}/items/{item_id}

Formats

json, xml

Authentication

Name Description
None No authentication.

Path Parameters

Parameter Type Description Constraints
item_id String id of the item mandatory=true, maxLength=28, minLength=1, nullable=false
list_id String id of the list mandatory=true, maxLength=28, minLength=1, nullable=false

In case of a failure Fault Document is returned.

Faults

Status Type Arguments Description
401 CustomerNotAuthenticatedException   Indicates that the customer is not authenticated and must be logged in.
403 CustomerNotAuthorizedException   Indicates that the authenticated customer is not the owner of the list
404 ProductListNotFoundException

productListId (String)

 Indicates that this list doesn't exist
404 ProductListItemNotFoundException

itemId (String)

 Indicates that this item doesn't exist

Sample

REQUEST:
DELETE /dw/shop/v15_6/product_lists/cdmeh9aaabqtwaaadjcLADJaTY/items/cdHYN9aaabZCEaaadj7dhW0d1L HTTP/1.1
Host: example.com
Content-Type: application/json; charset=UTF-8
Cookie: dwcustomer_9727b83e8e864fa4b6902a37bc70a12d=cdT3mHBc4s8q4y1bE9qaLNQIaW;
        dwsid=pATvWUO3KSdt-Kmcy-8-RsxKnoO4BMDwoec7ACVlW6tZNnhaOL7gt7mHqL-h7QYn5TyE61z0DeSMCqxngsWeHw==;

# in case of success:
 
RESPONSE:
HTTP/1.1 204 No Content
Content-Type : text/plain; charset=ISO-8859-1
Cache-Control: max-age=0,no-cache,no-store,must-revalidate


# in case of failure (authentication failed):
 
RESPONSE:
HTTP/1.1 401 Unauthorized
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "CustomerNotAuthenticatedException",
      "message" : "Customer must be authenticated."
   }
}

# in case of failure (authorization failed):
 
RESPONSE:
HTTP/1.1 403 Forbidden
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "CustomerNotAuthorizedException",
      "message" : "Customer is not authorized for this action."
   }
}

# in case of failure (list not found):
 
RESPONSE:
HTTP/1.1 404 Not Found
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "NotFoundException",
      "message" : "Productlist with id 'cdmeh9aaabqtwaaadjcLADJaTZ' not found."
   }
}

# in case of failure (item not found):
 
RESPONSE:
HTTP/1.1 404 Not Found
Expires: Thu, 01-Jan-1970 00:00:00 GMT
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "15.6",
   "fault" : 
   {
      "type" : "NotFoundException",
      "message" : "Productlist item with id 'cdHYN9aaabZCEaaadj7dhW0d1L' not found."
   }
}

© Copyright 2000-2020, salesforce.com inc. All rights reserved. Various trademarks held by their respective owners.

 Show URL Submit FeedbackPrivacy Policy
OCAPI obsolete versions 13.x and 14.x will be end of life in 2020 and versions 15.x and 16.x in 2021. For dates and more information, see the OCAPI versioning and deprecation policy and this Knowledge Article.
X Privacy Update: We use cookies to make interactions with our websites and services easy and meaningful, to better understand how they are used. By continuing to use this site you are giving us your consent to do this. Privacy Policy.