Product

Authentication

• HTTP Authentication, scheme: bearer

Product

Get list of products

Code samples

const data = null;

const xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener('readystatechange', function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open('GET', 'https://fakestoreapi.ru/product');
xhr.setRequestHeader('Accept', 'application/json');

xhr.send(data);

GET /product

Parameters

| Name | In | Type | Required | Description | | ------- | ----- | ------ | -------- | ------------------------------------ | ------ | | l | query | number | false | Items limit on page ( from 1 to 50 ) | | p | query | number | false | Items page ( min 1 ) | | n | query | string | false | Product name | | orderBy | query | string | false | Sort by ( name, price, discount ) | | sort | query | string | false | Sort method ( ASC | DESC ) | | pfrom | query | number | false | Product price from ( min 0 ) | | pto | query | number | false | Product price to ( min 1 ) | | cn | query | string | false | Product category name | | cid | query | string | false | Product category id |

Example responses

200 Response

{
  "data": [
    {
      "uuid": "17a54659-a06a-464f-a914-190cee7d4b1a",
      "name": "Nike",
      "price": 250,
      "discount": 15,
      "images": [
        {
          "_uuid": "string"
        }
      ],
      "rating": 0,
      "review_count": 0,
      "category": {
        "_uuid": "17a54659-a06a-464f-a914-190cee7d4b1a",
        "name": "Shoes"
      }
    }
  ],
  "price_range": {
    "min": 100,
    "max": 5000
  },
  "pagintaion": {
    "total": 240,
    "page": 1,
    "limit": 10,
    "totalPage": 24,
    "isLastPage": false
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	Products recived	ProductsListDetails
5XX	Unknown	Server error	None
4XX	Unknown	Check response message	None

This operation does not require authentication

Create product

Code samples

POST /product

Body parameter

name: New Balance 1906
price: 1000
categoryId: 17a54659-a06a-464f-a914-190cee7d4b1a
discount: 25
images:
  - []

Parameters

Name	In	Type	Required	Description
body	body	CreateProductDto	true	none

Example responses

201 Response

{
  "uuid": "17a54659-a06a-464f-a914-190cee7d4b1a",
  "name": "Nike",
  "price": 250,
  "discount": 15,
  "images": [
    {
      "_uuid": "string"
    }
  ],
  "rating": 0,
  "review_count": 0,
  "category": {
    "_uuid": "17a54659-a06a-464f-a914-190cee7d4b1a",
    "name": "Shoes"
  }
}

Responses

Status	Meaning	Description	Schema
201	Created	Product created	ProductDetails
5XX	Unknown	Server error	None
4XX	Unknown	Check response message	None

To perform this operation, you must be authenticated by means of one of the following methods: bearer

Get product by id

Code samples

const data = null;

const xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener('readystatechange', function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open('GET', 'https://fakestoreapi.ru/product/string');
xhr.setRequestHeader('Accept', 'application/json');

xhr.send(data);

GET /product/{id}

Parameters

Name	In	Type	Required	Description
id	path	string	true	Product id

Example responses

200 Response

{
  "uuid": "17a54659-a06a-464f-a914-190cee7d4b1a",
  "name": "Nike",
  "price": 250,
  "discount": 15,
  "images": [
    {
      "_uuid": "string"
    }
  ],
  "rating": 0,
  "review_count": 0,
  "category": {
    "_uuid": "17a54659-a06a-464f-a914-190cee7d4b1a",
    "name": "Shoes"
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	Product recived	ProductDetails
5XX	Unknown	Server error	None
4XX	Unknown	Check response message	None

This operation does not require authentication

Update product

Code samples

PATCH /product/{id}

Body parameter

name: New Balance 1906
price: 1000
discount: 25
removeImages:
  - 17a54659-a06a-464f-a914-190cee7d4b1a
  - 17a54659-a06a-464f-a914-190cee7d4b1a
images:
  - []

Parameters

Name	In	Type	Required	Description
id	path	string	true	Product id
body	body	UpdateProductDto	true	none

Responses

Status	Meaning	Description	Schema
200	OK	Product updated	None
5XX	Unknown	Server error	None
4XX	Unknown	Check response message	None

To perform this operation, you must be authenticated by means of one of the following methods: bearer

Remove product

Code samples

const data = null;

const xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener('readystatechange', function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open('DELETE', 'https://fakestoreapi.ru/product/string');
xhr.setRequestHeader('Authorization', 'Bearer {access-token}');

xhr.send(data);

DELETE /product/{id}

Parameters

Name	In	Type	Required	Description
id	path	string	true	Product id

Responses

Status	Meaning	Description	Schema
200	OK	Product removed	None
5XX	Unknown	Server error	None
4XX	Unknown	Check response message	None

To perform this operation, you must be authenticated by means of one of the following methods: bearer

Get reviews by product id

Code samples

const data = null;

const xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener('readystatechange', function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open('GET', 'https://fakestoreapi.ru/product/string/review');
xhr.setRequestHeader('Accept', 'application/json');

xhr.send(data);

GET /product/{id}/review

Parameters

Name	In	Type	Required	Description
l	query	number	false	Items limit on page ( from 1 to 50 )
p	query	number	false	Items page ( min 1 )
id	path	string	true	Product id

Example responses

200 Response

{
  "data": [
    {
      "_uuid": "17a54659-a06a-464f-a914-190cee7d4b1a",
      "content": "Best shoes",
      "rating": 5,
      "user": {}
    }
  ],
  "pagintaion": {
    "total": 240,
    "page": 1,
    "limit": 10,
    "totalPage": 24,
    "isLastPage": false
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	Reviews recived	ReviewListDetails
5XX	Unknown	Server error	None
4XX	Unknown	Check response message	None

This operation does not require authentication

Create product review

Code samples

const data = JSON.stringify({
  content: 'Best shoes',
  rating: 5,
});

const xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener('readystatechange', function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open('POST', 'https://fakestoreapi.ru/product/string/review');
xhr.setRequestHeader('Content-Type', 'application/json');
xhr.setRequestHeader('Accept', 'application/json');

xhr.send(data);

POST /product/{id}/review

Body parameter

{
  "content": "Best shoes",
  "rating": 5
}

Parameters

Name	In	Type	Required	Description
id	path	string	true	Product id
body	body	CreateReviewDto	true	none

Example responses

200 Response

{
  "_uuid": "17a54659-a06a-464f-a914-190cee7d4b1a",
  "content": "Best shoes",
  "rating": 5,
  "user": {}
}

Responses

Status	Meaning	Description	Schema
200	OK	Product review created	ReviewDetails
5XX	Unknown	Server error	None
4XX	Unknown	Check response message	None

This operation does not require authentication

Update product review

Code samples

const data = JSON.stringify({
  content: 'Best shoes',
  rating: 5,
});

const xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener('readystatechange', function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open('PATCH', 'https://fakestoreapi.ru/product/string/review/string');
xhr.setRequestHeader('Content-Type', 'application/json');

xhr.send(data);

PATCH /product/{prodid}/review/{reviewid}

Body parameter

{
  "content": "Best shoes",
  "rating": 5
}

Parameters

Name	In	Type	Required	Description
prodid	path	string	true	none
reviewid	path	string	true	none
id	path	string	true	Product id
body	body	UpdateReviewDto	true	none

Responses

Status	Meaning	Description	Schema
200	OK	Product review updated	None
5XX	Unknown	Server error	None
4XX	Unknown	Check response message	None

This operation does not require authentication

Delete product review

Code samples

const data = null;

const xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener('readystatechange', function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open('DELETE', 'https://fakestoreapi.ru/product/string/review/string');

xhr.send(data);

DELETE /product/{prodid}/review/{reviewid}

Parameters

Name	In	Type	Required	Description
prodid	path	string	true	none
reviewid	path	string	true	none
id	path	string	true	Product id

Responses

Status	Meaning	Description	Schema
200	OK	Product review deleted	None
5XX	Unknown	Server error	None
4XX	Unknown	Check response message	None

This operation does not require authentication