<!-- order: 22 -->

Produktový katalóg — API

SScloud poskytuje REST API pre produktový katalóg — zoznam produktov, detaily, kategórie, značky a filtrovanie.

Autentifikácia

Čítanie (GET) je verejné — nevyžaduje autentifikáciu.

Zápis (POST/PUT/DELETE) vyžaduje Bearer token (Laravel Sanctum) + admin rolu.

Authorization: Bearer {your-api-token}

Endpointy


Zoznam produktov

GET /api/v1/products

Vráti zoznam aktívnych produktov s podporou filtrovania, zoradenia a stránkovania.

Parametre:

| Parameter | Typ | Popis |

|-----------|-----|-------|

| category | string | Filtrovať podľa kategórie |

| brand | string | Filtrovať podľa značky (partial match) |

| search | string | Vyhľadávanie v názve, popise, SKU |

| price_min | number | Minimálna cena |

| price_max | number | Maximálna cena |

| sort_by | string | Zoradiť podľa: name, price_eur, capacity_kwh, power_kw, display_order, created_at |

| sort_order | string | asc alebo desc (default: asc) |

| per_page | integer | Počet na stranu (max 100, default: 20) |

Odpoveď:

{
  "success": true,
  "data": [
    {
      "id": 1,
      "sku": "BAT-HUAWEI-5K",
      "name": "Huawei Luna 2000 5 kWh batéria",
      "category": "battery",
      "category_label": "Batérie",
      "brand": "Huawei",
      "model": "Luna 2000-5",
      "price_eur": 3200.00,
      "price_with_installation_eur": 4500.00,
      "display_price": "4 500,00 € (s montážou)",
      "capacity_kwh": 5.0,
      "power_kw": 5.0,
      "image_url": null,
      "is_active": true,
      "display_order": 1
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 2,
    "per_page": 20,
    "total": 25
  }
}

Detail produktu

GET /api/v1/products/{product}

Podrobné informácie o produkte.

Odpoveď:

{
  "success": true,
  "data": {
    "id": 1,
    "sku": "BAT-HUAWEI-5K",
    "name": "Huawei Luna 2000 5 kWh batéria",
    "category": "battery",
    "category_label": "Batérie",
    "brand": "Huawei",
    "model": "Luna 2000-5",
    "price_eur": 3200.00,
    "price_with_installation_eur": 4500.00,
    "display_price": "4 500,00 € (s montážou)",
    "capacity_kwh": 5.0,
    "power_kw": 5.0,
    "image_url": null,
    "is_active": true,
    "display_order": 1,
    "description": "Modulárna batéria pre domáce FVE systémy...",
    "specifications": {
      "kapacita": "5 kWh",
      "max_vykon": "5 kW",
      "chemia": "LFP (LiFePO4)",
      "zivotnost": "6000 cyklov",
      "zaruka": "10 rokov"
    },
    "created_at": "2026-04-21T10:00:00+02:00",
    "updated_at": "2026-04-21T10:00:00+02:00"
  }
}

Kategórie produktov

GET /api/v1/products/categories

Vráti zoznam všetkých produktových kategórií.

Odpoveď:

{
  "success": true,
  "data": [
    { "key": "solar_panel", "label": "Solárne panely" },
    { "key": "battery", "label": "Batérie" },
    { "key": "wallbox", "label": "Wallboxy / EV nabíjačky" },
    { "key": "heat_pump", "label": "Tepelné čerpadlá" },
    { "key": "smart_home", "label": "Smart home zariadenia" },
    { "key": "inverter", "label": "Invertory" },
    { "key": "accessory", "label": "Príslušenstvo" }
  ]
}

Značky

GET /api/v1/products/brands

Vráti unikátny zoznam značiek aktívnych produktov.

Odpoveď:

{
  "success": true,
  "data": ["ABL", "BYD", "Daikin", "Deye", "Fronius", "go-e", "Home Assistant", "Huawei", "Jinko", "Longi", "Mitsubishi", "REC", "Shelly", "SolarEdge", "Sungrow", "Tesla", "TP-Link", "Viessmann", "Wallbox"]
}

Vytvoriť produkt (admin only)

POST /api/v1/products

Parametre:

| Parameter | Typ | Povinné | Popis |

|-----------|-----|---------|-------|

| sku | string | áno | Unikátny kód produktu |

| name | string | áno | Názov produktu |

| category | string | áno | Kategória |

| description | string | nie | Popis |

| brand | string | nie | Značka |

| model | string | nie | Model |

| price_eur | number | nie | Cena bez montáže |

| price_with_installation_eur | number | nie | Cena s montážou |

| specifications | object | nie | Technické parametre |

| capacity_kwh | number | nie | Kapacita v kWh |

| power_kw | number | nie | Výkon v kW |

| image_url | string | nie | URL obrázka |

| is_active | boolean | nie | Aktívny (default: true) |

| display_order | integer | nie | Poradie zobrazenia |

Odpoveď:

{
  "success": true,
  "message": "Produkt bol vytvorený.",
  "data": { ... }
}

Upraviť produkt (admin only)

PUT /api/v1/products/{product}

Rovnaké parametre ako pri vytváraní (všetky optional).


Zmazať produkt (admin only)

DELETE /api/v1/products/{product}


Kategórie produktov

| Kľúč | Popis |

|------|-------|

| solar_panel | Solárne panely |

| battery | Batérie |

| wallbox | Wallboxy / EV nabíjačky |

| heat_pump | Tepelné čerpadlá |

| smart_home | Smart home zariadenia |

| inverter | Invertory |

| accessory | Príslušenstvo |


Odporúčania

Použite endpoint /api/v1/recommendations pre personalizované produktové odporúčania na základe FVE dát a energetickej zoznámky.


SScloud — Inteligentné riešenia pre fotovoltiku