Reviews and Comments Management via Venddor IO API

Introduction

Venddor IO offers a dedicated API interface for managing reviews and comments, enabling businesses to engage with their customer feedback effectively. The following guide walks through the various functionalities available.

API Endpoints for Reviews & Comments

1. General Discussions

URL: http://example.com/api/2.0/discussions/

Purpose: Retrieve or submit general reviews and comments.

Supported Methods: GET, POST

2. Specific Discussion

URL: http://example.com/api/2.0/discussions/:id

Purpose: Interact with a specific review or comment.

Supported Methods: GET, PUT, DELETE

3. Product-related Discussions

URL: http://example.com/api/2.0/products/:p_id/discussions/

Purpose: Fetch or submit reviews and comments tied to a particular product.

4. Specific Product-related Discussion

URL: http://example.com/api/2.0/products/:p_id/discussions/:id

Purpose: Access or modify a particular review or comment associated with a specific product.

Supported Methods: GET, PUT, DELETE

Pagination & Filtering

For easy retrieval and viewing of reviews and comments, Venddor IO provides pagination and filtering capabilities. The table below outlines the available parameters:

Parameter	Default Value	Description
page	1	Display reviews and comments from the defined page number.
items_per_page	10	Set the number of reviews and comments per page.
sort_by	timestamp	Sort feedback based on criteria like name, ip_address, timestamp, or status.
...	...	...
object_type		Filter feedback by their related object. E.g., P for product, C for category, A for a page, etc.
...	...	...

Examples

• Retrieve 20 reviews and comments from the initial page:
  http://example.com/api/2.0/discussions?items_per_page=20
• Obtain 20 reviews from the 5th page:
  http://example.com/api/2.0/discussions?items_per_page=20
• Fetch reviews and comments for the product with product_id=167:
  http://example.com/api/2.0/products/167/discussions

Fields for Reviews & Comments

Reviews and comments in Venddor IO are characterized by various attributes or fields. Mandatory fields are highlighted with an asterisk (*).

Field Name	Description	Default Value	Supported Values
Field details would be listed here