This API specification is available for download as an Open API 3.0 YAML file:
The following operations for creating, retrieving and deleting reviews are available:
/categories/{categoriesKey}/products/{productKey}/reviews
This operation submits a user review for a product.
public com.intershop.component.rest.capi.resourceobject.LinkRO com.intershop.sellside.rest.common.capi.resource.review.ReviewListResource.addReview(com.intershop.sellside.rest.common.capi.resourceobject.NewReviewRO)
Location | Name | Format | Description |
---|---|---|---|
in path | categoriesKey | string | Required | The category ID | Example: 153 |
in path | productKey | string | Required | The product SKU | Example: 10809311 |
201 - Created
400 - Bad Request
401 - Unauthorized
404 - Not Found
422 - Unprocessable Entity
/categories/{categoriesKey}/products/{productKey}/reviews/{ReviewKey}
This operation deletes a specific user review of a specific product.
public void com.intershop.sellside.rest.common.capi.resource.review.ReviewItemResource.deleteProductReviewByID()
Location | Name | Format | Description |
---|---|---|---|
in path | categoriesKey | string | Required | The category ID | Example: 153 |
in path | productKey | string | Required | The product SKU | Example: 10809311 |
in path | ReviewKey | string | Required | The review ID | Example: aUAKDgAFMa8AAAF2XvNMKHUM |
204 - No Content
401 - Unauthorized
403 - Forbidden
404 - Not Found
/products/{productKey}/reviews
This operation submits a user review for a product.
public com.intershop.component.rest.capi.resourceobject.LinkRO com.intershop.sellside.rest.common.capi.resource.review.ReviewListResource.addReview(com.intershop.sellside.rest.common.capi.resourceobject.NewReviewRO)
Location | Name | Format | Description |
---|---|---|---|
in path | productKey | string | Required | The product SKU | Example: 10809311 |
201 - Created
400 - Bad Request
401 - Unauthorized
404 - Not Found
422 - Unprocessable Entity
/products/{productKey}/reviews/{ReviewKey}
This operation deletes a specific user review of a specific product.
public void com.intershop.sellside.rest.common.capi.resource.review.ReviewItemResource.deleteProductReviewByID()
Location | Name | Format | Description |
---|---|---|---|
in path | productKey | string | Required | The product SKU | Example: 10809311 |
in path | ReviewKey | string | Required | The review ID | Example: aUAKDgAFMa8AAAF2XvNMKHUM |
204 - No Content
401 - Unauthorized
403 - Forbidden
404 - Not Found
/categories/{categoriesKey}/products{spgid}/{productKey}/reviews/{ReviewKey}
This operation returns a specific user review of a specific product.
public com.intershop.sellside.rest.common.capi.resourceobject.ReviewRO com.intershop.sellside.rest.common.capi.resource.review.ReviewItemResource.getProductReviewByID()
Location | Name | Format | Description |
---|---|---|---|
in path | spgid | string | The secure personal group identifier (submitted as matrix parameter ;spgid=<PGID> ). | Example: FUOGrzQ_VjORpGaN8DRGmLLE0000 |
in path | categoriesKey | string | Required | The category ID | Example: 153 |
in path | productKey | string | Required | The product SKU | Example: 10809311 |
in path | ReviewKey | string | Required | The review ID | Example: aUAKDgAFMa8AAAF2XvNMKHUM |
200 - OK
401 - Unauthorized
404 - Not Found
/products{spgid}/{productKey}/reviews
This operation returns a list of all user reviews for a product.
public com.intershop.component.rest.capi.resourceobject.ResourceCollectionRO com.intershop.sellside.rest.common.capi.resource.review.ReviewListResource.getProductReviews(java.lang.String,java.lang.Boolean,java.lang.Boolean)
Location | Name | Format | Description |
---|---|---|---|
in path | spgid | string | The secure personal group identifier (submitted as matrix parameter ;spgid=<PGID> ). | Example: FUOGrzQ_VjORpGaN8DRGmLLE0000 |
in path | productKey | string | Required | The product SKU | Example: 10809311 |
in query | attrs | string | attrs can contain the following attribute names separated by comma:- authorname : Name of the author (firstname and lastname, showAuthorNameFlag)- content : Content of the review- creationdate : Creation date of the review- rating : Rating of the review (0..5)- status : Status of the review (NEW, APPROVED)- title : Title of the review- localeid : Locale id of the review- own : Flag if the review is owned by the requested user | Example: status,rating |
in query | own | boolean | Flag that determines if the review list should contain only reviews owned by the requested user or only reviews from other authors. If the flag is omitted, all reviews are returned. | Example: false |
in query | localespecific | boolean | Flag that determines if the review list should contain reviews for the requested locale or all reviews independent from the requested locale. | Example: false | Default: false |
200 - OK
401 - Unauthorized
404 - Not Found
/products{spgid}/{productKey}/reviews/{ReviewKey}
This operation returns a specific user review of a specific product.
public com.intershop.sellside.rest.common.capi.resourceobject.ReviewRO com.intershop.sellside.rest.common.capi.resource.review.ReviewItemResource.getProductReviewByID()
Location | Name | Format | Description |
---|---|---|---|
in path | spgid | string | The secure personal group identifier (submitted as matrix parameter ;spgid=<PGID> ). | Example: FUOGrzQ_VjORpGaN8DRGmLLE0000 |
in path | productKey | string | Required | The product SKU | Example: 10809311 |
in path | ReviewKey | string | Required | The review ID | Example: aUAKDgAFMa8AAAF2XvNMKHUM |
200 - OK
401 - Unauthorized
404 - Not Found
/categories/{categoriesKey}/products{spgid}/{productKey}/reviews
This operation returns a list of all user reviews for a product.
public com.intershop.component.rest.capi.resourceobject.ResourceCollectionRO com.intershop.sellside.rest.common.capi.resource.review.ReviewListResource.getProductReviews(java.lang.String,java.lang.Boolean,java.lang.Boolean)
Location | Name | Format | Description |
---|---|---|---|
in path | spgid | string | The secure personal group identifier (submitted as matrix parameter ;spgid=<PGID> ). | Example: FUOGrzQ_VjORpGaN8DRGmLLE0000 |
in path | categoriesKey | string | Required | The category ID | Example: 153 |
in path | productKey | string | Required | The product SKU | Example: 10809311 |
in query | attrs | string | attrs can contain the following attribute names separated by comma:- authorname : Name of the author (firstname and lastname, showAuthorNameFlag)- content : Content of the review- creationdate : Creation date of the review- rating : Rating of the review (0..5)- status : Status of the review (NEW, APPROVED)- title : Title of the review- localeid : Locale id of the review- own : Flag if the review is owned by the requested user | Example: status,rating |
in query | own | boolean | Flag that determines if the review list should contain only reviews owned by the requested user or only reviews from other authors. If the flag is omitted, all reviews are returned. | Example: false |
in query | localespecific | boolean | Flag that determines if the review list should contain reviews for the requested locale or all reviews independent from the requested locale. | Example: false | Default: false |
200 - OK
401 - Unauthorized
404 - Not Found
Link
ResourceAttribute
objects. the list of attributesResourceAttribute
: An attributeResourceAttribute
about
alternate
appendix
archives
author
bookmark
canonical
chapter
collection
contents
copyright
create-form
current
describedby
describes
disclosure
duplicate
edit
edit-form
edit-media
enclosure
first
glossary
help
hosts
hub
icon
index
item
last
latest-version
license
lrdd
monitor
monitor-group
next
next-archive
nofollow
noreferrer
payment
predecessor-version
prefetch
prev
preview
previous
prev-archive
privacy-policy
profile
related
replies
search
section
self
service
start
stylesheet
subsection
successor-version
tag
terms-of-service
type
up
version-history
via
working-copy
working-copy-of
ResourceAttribute
object. An attributeResourceAttribute
int32
int32
int32
LinkRO
objects. The list of elementsLinkRO
: A Link pointing to a resourceLink
ResourceAttribute
objects. the list of attributesResourceAttribute
: An attributeResourceAttribute
about
alternate
appendix
archives
author
bookmark
canonical
chapter
collection
contents
copyright
create-form
current
describedby
describes
disclosure
duplicate
edit
edit-form
edit-media
enclosure
first
glossary
help
hosts
hub
icon
index
item
last
latest-version
license
lrdd
monitor
monitor-group
next
next-archive
nofollow
noreferrer
payment
predecessor-version
prefetch
prev
preview
previous
prev-archive
privacy-policy
profile
related
replies
search
section
self
service
start
stylesheet
subsection
successor-version
tag
terms-of-service
type
up
version-history
via
working-copy
working-copy-of
ResourceAttribute
object. An attributeResourceAttribute
string
literals. The keys to sort forNewReview
ResourceAttribute
objects. The list of attributesResourceAttribute
: An attributeResourceAttribute
Good choice
I am satisfied with my purchase. The quality is very good for the price. I still wish there were more features.
int32
| Example: 5
true
ResourceAttribute
object. An attributeResourceAttribute
Review
ResourceAttribute
objects. The list of attributesResourceAttribute
: An attributeResourceAttribute
Alexandra
Heimroth
Good choice
I am satisfied with my purchase. The quality is very good for the price. I still wish there were more features.
y60KDACwgR8AAAFB0MKGQOQj
date-time
int32
| Example: 5
NEW (NOT APPROVED)
true
en_US
ResourceAttribute
object. An attributeResourceAttribute
The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.