Produkty - recenze a hodnocení

pro práci s produkty lze využívat webhooky.
recenze a hodnocení jsou spojeny do jednoho záznamu.
více informací na Hodnocení a recenze

Seznam recenzí a hodnocení

GET

/api/v2/products/ratings-reviews

Seznam recenzí a hodnocení › query Parameters

product_code

string

kód produktu

email

string · email

email zákazníka

page

integer

stránka

Default: 1

Seznam recenzí a hodnocení › Responses

200

current_page

integer · min: 1

aktuální strana

current_page_items

integer

počet položek na aktuální straně

number_of_items

integer

celkový počet položek

number_of_pages

integer

celkový počet stran

object[]

GET/api/v2/products/ratings-reviews

curl --request GET \
  --url /api/v2/products/ratings-reviews

shell

Example Responses

{
  "current_page": 1,
  "current_page_items": 1,
  "number_of_items": 1,
  "number_of_pages": 1,
  "ratings_reviews": [
    {
      "rating_review_id": 0,
      "product": {
        "product_id": 0,
        "code": "code"
      },
      "customer": {
        "email": "test@example.com",
        "code": "code",
        "customer_name": "customer_name"
      },
      "review": {
        "positives": "positives",
        "negatives": "negatives",
        "creation_time": "2026-04-28T13:57:48+02:00",
        "answer": {
          "user_name": "user_name",
          "text": "text",
          "creation_time": "2026-04-28T13:57:48+02:00"
        }
      },
      "rating": {
        "score": 1,
        "creation_time": "2026-04-28T13:57:48+02:00"
      },
      "approved_yn": true,
      "approved_time": "2026-04-28T13:57:48+02:00"
    }
  ]
}

json

application/json

Vytvoření recenze a hodnocení

POST

/api/v2/products/ratings-reviews

Vytvoří recenzi a hodnocení produktu. Každý zákazník může hodnotit produkt pouze jednou.

Vytvoření recenze a hodnocení › Request Body

object[] · required

Vytvoření recenze a hodnocení › Responses

200

object[]

POST/api/v2/products/ratings-reviews

curl --request POST \
  --url /api/v2/products/ratings-reviews \
  --header 'Content-Type: application/json' \
  --data '
{
  "ratings_reviews": [
    {
      "product": {
        "code": "code"
      },
      "customer": {
        "email": "test@example.com",
        "customer_name": "customer_name"
      },
      "review": {
        "positives": "positives",
        "negatives": "negatives",
        "creation_time": "2026-04-28T13:57:48+02:00",
        "answer": {
          "user_name": "user_name",
          "text": "text",
          "creation_time": "2026-04-28T13:57:48+02:00"
        }
      },
      "rating": {
        "score": 1,
        "creation_time": "2026-04-28T13:57:48+02:00"
      }
    }
  ]
}
'

shell

Example Request Body

{
  "ratings_reviews": [
    {
      "product": {
        "code": "code"
      },
      "customer": {
        "email": "test@example.com",
        "customer_name": "customer_name"
      },
      "review": {
        "positives": "positives",
        "negatives": "negatives",
        "creation_time": "2026-04-28T13:57:48+02:00",
        "answer": {
          "user_name": "user_name",
          "text": "text",
          "creation_time": "2026-04-28T13:57:48+02:00"
        }
      },
      "rating": {
        "score": 1,
        "creation_time": "2026-04-28T13:57:48+02:00"
      }
    }
  ]
}

json

Example Responses

{
  "ratings_reviews": [
    {
      "created_yn": true,
      "messages": [
        {
          "object": "object",
          "property": "property",
          "message": "message",
          "level": "info"
        }
      ]
    }
  ]
}

json

application/json

Smazání recenzí a hodnocení

DELETE

/api/v2/products/ratings-reviews

Smazání recenzí a hodnocení › query Parameters

rating_review_id

integer

ID hodnocení a recenze

rating_review_ids

QueryParameterArrayInt

ID hodnocení a recenze oddělené středníkem ; nebo jako pole

Smazání recenzí a hodnocení › Responses

200

object[]

Produkty - seznamy Provozovatel eshopu

Seznam recenzí a hodnocení

GET

/api/v2/products/ratings-reviews

Seznam recenzí a hodnocení › query Parameters

product_code

string

kód produktu

email

string · email

email zákazníka

page

integer

stránka

Default: 1

Seznam recenzí a hodnocení › Responses

200

current_page

integer · min: 1

aktuální strana

current_page_items

integer

počet položek na aktuální straně

number_of_items

integer

celkový počet položek

number_of_pages

integer

celkový počet stran

object[]

Vytvoření recenze a hodnocení

POST

/api/v2/products/ratings-reviews

Vytvoří recenzi a hodnocení produktu. Každý zákazník může hodnotit produkt pouze jednou.

Vytvoření recenze a hodnocení › Request Body

object[] · required

Vytvoření recenze a hodnocení › Responses

200

object[]

Smazání recenzí a hodnocení

DELETE

/api/v2/products/ratings-reviews

Smazání recenzí a hodnocení › query Parameters

rating_review_id

integer

ID hodnocení a recenze

rating_review_ids

QueryParameterArrayInt

ID hodnocení a recenze oddělené středníkem ; nebo jako pole

Smazání recenzí a hodnocení › Responses

200

object[]