Seznam produktů

Získá seznam produktů s možností filtrování, stránkování a řazení. Endpoint umožňuje zobrazit základní informace o produktech včetně jejich atributů, cenových statistik, informací o trzích a průměrných ukazatelů popularity. Podporuje pokročilé filtrování podle kategorií, značek, generalizovaných produktů a vlastních atributů.

API specifikace

/admin/product

Retrieves a paginated list of products with optional filtering, sorting, and ordering.

Request parameters

Responses

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Organic Whole Milk 1L",
    "attributes": [
      {
        "type": "ProductAttributeStringValue",
        "definitionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "definitionName": "Origin",
        "value": "Denmark"
      },
      {
        "type": "ProductAttributeEnumValue",
        "definitionId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "definitionName": "Fat Content",
        "value": {
          "optionId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
          "value": "3.5%"
        }
      }
    ],
    "externalId": "EAN-5901234123457",
    "productCount": 1,
    "generalizedProduct": {
      "id": "d4e5f6a7-b8c9-0123-def0-234567890123",
      "name": "Milk"
    },
    "variant": {
      "id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
      "name": "1L Carton"
    },
    "brand": {
      "id": "f6a7b8c9-d0e1-2345-f012-456789012345",
      "name": "Arla"
    },
    "minPrice": 1.49,
    "maxPrice": 2.29,
    "summary": {
      "lifetime": 365.0,
      "customers": 15420,
      "totalQuantity": 48500.0,
      "totalPrice": 87300.5,
      "quantityPerCustomer": 3.15
    },
    "productInMarket": {
      "a7b8c9d0-e1f2-3456-0123-567890123456": {
        "market": {
          "id": "a7b8c9d0-e1f2-3456-0123-567890123456",
          "name": "Copenhagen Store"
        },
        "priceType": {
          "id": "b8c9d0e1-f234-5670-1234-678901234567",
          "name": "Regular"
        },
        "price": 1.99,
        "validFrom": "2024-01-01T00:00:00Z",
        "validTo": null,
        "lastUpdated": "2024-06-15T10:30:00Z"
      }
    },
    "avgPopularityStat": {
      "granularity": 30,
      "customerCount": 1250,
      "basketCount": 1580,
      "quantity": 2150.0,
      "growthRate": 0.12,
      "trend": "Increasing",
      "lastUpdated": "2024-06-15T00:00:00Z"
    }
  }
]

15 January 2026