Trgovine.si

API dokumentacija

Osnovni javni endpointi za branje trgovine, izdelkov, filtrov in embed dogodkov.

GET /api/v1/shops/{public_key}

Podatki o trgovini in nastavitvah prikaza.

GET /api/v1/shops/{public_key}/categories

Kategorije, ki so dovoljene za prikaz v trgovini.

GET /api/v1/shops/{public_key}/products

Seznam izdelkov z iskanjem, kategorijami, tagi, lastnostmi, ceno, sortiranjem in paginacijo.

GET /api/v1/shops/{public_key}/products/{slug}

Podrobnosti posameznega izdelka.

GET /api/v1/shops/{public_key}/tags

Tagi, relevantni za trenutno trgovino.

GET /api/v1/shops/{public_key}/attributes

Filterable lastnosti in možnosti.

POST /api/v1/shops/{public_key}/cart/validate

Strežniška validacija košarice z aktualnimi cenami in zalogo.

POST /api/v1/shops/{public_key}/cart/session

Pripravi hosted checkout povezavo za košarico iz plugina.

POST /api/v1/shops/{public_key}/orders

Oddaja naročila prek javnega API za pripravljene integracije.

POST /api/v1/shops/{public_key}/inquiries

Oddaja povpraševanja prek javnega API.

POST /api/v1/shops/{public_key}/events

Zapis embed dogodkov: view, product_view, add_to_cart, checkout_start.

Primer odgovora

JSON

{
    "success": true,
    "data": {
        "shop": {
            "name": "Demo trgovina",
            "mode": "all_products",
            "currency": "EUR"
        },
        "products": [
            {
                "title": "USB ključek 64 GB",
                "price_gross": 9.9
            }
        ]
    }
}

Primer dogodka

JSON

{
    "event_type": "add_to_cart",
    "product_id": 123,
    "source_url": "https://primer.si/ponudba"
}