Listing Carts: Portal Carts
Portal carts are consumer-only (e.g. VOW or Portal role) carts that are automatically generated for each consumer. While their contents can be modified, the carts themselves cannot be deleted or renamed.
Supported Roles
| Role | Reads | Writes | Notes |
|---|---|---|---|
| IDX | No | No | |
| Public | No | No | |
| VOW | Yes | No | |
| Portal | Yes | No | |
| Private | No | No |
More information about roles may be found here.
Available Services
Portal Carts
Portal carts as a subresource of contacts are only available in a private role.
/<API Version>/listingcarts/portal
/<API Version>/contacts/<Contact.Id>/listingcarts/portal
| HTTP Method | Description | Notes |
|---|---|---|
| GET | Returns all Portal carts associated with the current consumer | |
| POST,PUT,DELETE | Returns HTTP 405 (Method Not Allowed) | Not implemented |
GET Request
Parameters:
- None
GET Response
See the GET request section for listing carts.
Favorites Cart
Portal carts as a subresource of contacts are only available in a private role.
/<API Version>/listingcarts/portal/favorites
/<API Version>/contacts/<Contact.Id>/listingcarts/portal/favorites
| HTTP Method | Description | Notes |
|---|---|---|
| GET | Returns favorites cart associated with the current consumer | |
| POST | Adds listing IDs to current consumers favorites cart | |
| PUT | Returns HTTP 405 (Method Not Allowed) | Not implemented |
| DELETE | Remove listing IDs from current consumer favorites cart |
POST Request Body
Example:
{
"D": {
"ListingIds": ["20100912153422758914000000", "20100912153422758914000001"]
}
}
DELETE Request
Parameters:
| Parameter | Required | Description |
|---|---|---|
ListingIds |
Yes | Comma separated list of listing IDs to be removed. |
GET/POST/DELETE Response
{
"D": {[{
"ResourceURI": "/vX/listingcarts/20100912153422758914000000",
"Id": "20100912153422758914000000",
"Name": "Favorites",
"ListingCount": 2,
"CreatedBy": "20060412165917817933000000",
"PortalCartType": "Favorites",
"VowAdded": [],
"VowRemoved": [],
"ListingIds": ["20100912153422758914000000", "20100912153422758914000001"]
}]}
}Rejects Cart
Portal carts as a subresource of contacts are only available in a private role.
/<API Version>/listingcarts/portal/rejects
/<API Version>/contacts/<Contact.Id>/listingcarts/portal/rejects
| HTTP Method | Description | Notes |
|---|---|---|
| GET | Returns rejects cart associated with the current consumer | |
| POST | Adds listing IDs to current consumers rejects cart | |
| PUT | Returns HTTP 405 (Method Not Allowed) | Not implemented |
| DELETE | Remove listing IDs from current consumer rejects cart |
POST Request Body
Example:
{
"D": {
"ListingIds": ["20100912153422758914000000", "20100912153422758914000001"]
}
}
DELETE Request
Parameters:
| Parameter | Required | Description |
|---|---|---|
ListingIds |
Yes | Comma separated list of listing IDs to be removed. |
GET/POST/DELETE Response
{
"D": {[{
"ResourceURI": "/vX/listingcarts/20100912153422758914000000",
"Id": "20100912153422758914000000",
"Name": "Rejects",
"ListingCount": 2,
"CreatedBy": nil,
"PortalCartType": "Rejects",
"VowAdded": [],
"VowRemoved": [],
"ListingIds": ["20100912153422758914000000", "20100912153422758914000001"]
}]}
}Portal Cart Description
See the Listing Cart Description section for listing carts.
Expansions
| Expansion | Roles | Single Record Only? | Selection Support? | Description |
|---|---|---|---|---|
ListingIds |
Private, Portal, VOW | No | No | An array of ListingIds contained in the cart. Favorites/Rejects routes will always return as if this were requested |