Products API

Manage and retrieve product information, variations, and social proof (reviews/FAQs).

GET/client/v1/products

List Products

Retrieve a paginated list of products. Supports sparse fieldsets via the 'fields' parameter.

Request BodyJSON

fieldsOptional · String

Comma-separated list of fields to return (e.g., id,name,slug).

pageOptional · Number

Page number for pagination.

limitOptional · Number

Number of items per page (default: 20).

Error Responses

400

INVALID_PARAMS

Invalid query parameters provided.

500

INTERNAL_SERVER_ERROR

Unexpected error on the server side.

Sample Request

// GET /client/v1/products?fields=id,name,slug&limit=2
// No body required

Success Response

200 OK

{
  "success": true,
  "data": [
    {
      "id": 1005267385,
      "name": "Máy hút sữa Momcozy V2",
      "slug": "may-hut-sua-momcozy-v2"
    },
    {
      "id": 1002345678,
      "name": "Bình sữa Avent",
      "slug": "binh-sua-avent"
    }
  ],
  "pagination": {
    "total": 150,
    "page": 1,
    "limit": 2
  }
}

GET/client/v1/products/:id

Product Detail

Get full details of a specific product by its 10-digit ID.

Request BodyJSON

idRequired · String

The 10-digit numeric ID of the product.

fieldsOptional · String

Sparse fieldsets support.

Error Responses

404

PRODUCT_NOT_FOUND

The requested product ID does not exist.

Sample Request

// GET /client/v1/products/1005267385

Success Response

200 OK

{
  "success": true,
  "data": {
    "id": 1005267385,
    "name": "Máy hút sữa Momcozy V2",
    "shop_id": 3751191227,
    "vendor_name": "Momcozy",
    "variants": [...],
    "reviews_summary": {
      "total": 1104,
      "average": 5
    }
  }
}

Products API

Request BodyJSON

Error Responses

Request BodyJSON

Error Responses

Related Product Resources