Za razvijalce

Povežite Sellvio s svojim sistemi

Sellvio ni zaprt otok. Prek API-ja lahko matične podatke svoje trgovine – izdelke, kategorije, marke, parametre in naročila – preberete v svoje zunanje sisteme: ERP, skladišče, izdajanje računov ali lastno aplikacijo. Brez ročnega izvoza.

Dokumentacija API je v angleščini.

# 1. zahtevaj Bearer token
curl -X POST https://your-domain.com/oauth/token \
  -F "client_id=$CLIENT_ID" \
  -F "client_secret=$CLIENT_SECRET" \
  -F "grant_type=client_credentials"

# 2. pridobi naročila s tokenom
curl "https://your-domain.com/api/v2/orders?limit=10" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Accept: application/json"

Najprej prek OAuth 2.0 zahtevate token, nato z njim kličete končne točke. Token je veljaven 2 uri.

En API, celoten katalog

Izdelki, kategorije, marke, parametri, filtri in naročila – vse na istem vmesniku REST, v obliki JSON. Ena avtentikacija, ena dokumentacija, ena logika.

OAuth 2.0 in scopes (obsegi dostopa)

Skrbnik trgovine lahko ustvari poljubno število API-dostopov in za vsakega posebej določi, do katerih podatkov lahko dostopa (scopes). Dostop je natanko tako širok, kot je potrebno.

Sinhronizacija med več trgovinami Sellvio

API lahko služi tudi kot vir za sinhronizacijski modul: ena glavna trgovina zagotavlja matične podatke, druge pa se posodabljajo iz nje. Istega kataloga ni treba vzdrževati dvakrat.

Razpoložljive končne točke

Avtorizacija

Zahtevajte Bearer token s svojima client_id in client_secret.

  • POST/oauth/token

Izdelki

Seznam izdelkov s filtri (naziv, šifra izdelka, status, marka, kategorija) in podrobnosti posameznega izdelka.

  • GET/api/v2/products
  • GET/api/v2/products/{id}

Kategorije

Izpis kategorij izdelkov in pridobivanje podatkov posamezne kategorije.

  • GET/api/v2/categories
  • GET/api/v2/categories/{id}

Marke

Seznam mark z iskanjem in podrobnosti posamezne marke.

  • GET/api/v2/brands
  • GET/api/v2/brands/{id}

Parametri izdelkov

Izpis vrednosti parametrov, dodeljenih izdelkom.

  • GET/api/v2/product-parameters

Filtri izdelkov

Izpis vrednosti filtrov, dodeljenih izdelkom.

  • GET/api/v2/product-filters

Naročila

Izpis naročil po ID-ju, statusu, e-poštnem naslovu ali časovnem obdobju in podrobnosti posameznega naročila.

  • GET/api/v2/orders
  • GET/api/v2/orders/{id}

AI

Generiranje besedila z motorjem Sellvio AI, klicano neposredno iz vašega delovnega toka.

  • POST/api/v2/ai/generate

REST · JSON · OAuth 2.0 · osnovni URL je domena vaše trgovine · končne točke za sezname lahko odgovorijo tudi v obliki JSON, XLSX in CSV

Začetek, korak za korakom

1

Dokumentacija

Odprite referenco API in preglejte končne točke ter obliko zahtev in odgovorov.

2

Ključ API

Klici se preverjajo s ključem API, ki ga lahko zahtevate za svoj račun Sellvio.

3

Testiranje

Preizkusite končne točke pred zagonom – v Postmanu zahteve zaženete z enim klikom.

4

Zagon

Povežite produkcijski sistem in nastavite webhooke za pomembne dogodke.

Vgradite ga v svoje procese

Imate vprašanja o omejitvah zahtevkov, cenah ali ravnanju s podatki? Odgovorila vam bo naša razvojna ekipa – razvijalec razvijalcu, v razumljivem jeziku.

Dokumentacija API ↗EN

Dokumentacija API je v angleščini.