Fejlesztőknek

Kösd össze a Sellviót a saját rendszereiddel

A Sellvio nem zárt sziget. Az API-n keresztül a boltod törzsadatai – termékek, kategóriák, gyártók, paraméterek és rendelések – kiolvashatók a külső rendszereidbe: ERP, raktár, számlázó vagy a saját alkalmazásod. Manuális exportálás nélkül.

Az API-dokumentáció angol nyelvű.

# 1. Bearer token kérése
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. rendelések lekérése a tokennel
curl "https://your-domain.com/api/v2/orders?limit=10" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Accept: application/json"

Először OAuth 2.0-val tokent kérsz, azzal hívod a végpontokat. A token 2 órán át érvényes.

Egy API, az egész katalógus

Termékek, kategóriák, gyártók, paraméterek, szűrők és rendelések – mind ugyanazon a REST-felületen, JSON-ban. Egy hitelesítés, egy dokumentáció, egy logika.

OAuth 2.0 és jogosultsági körök

A bolt adminisztrátora tetszőleges számú API-hozzáférést hozhat létre, és külön szabályozza, melyik adatkörhöz (scope) férhet hozzá. A hozzáférés így pontosan akkora, amekkorára szükség van.

Szinkron több Sellvio bolt között

Az API a szinkronizációs modul forrásaként is használható: egy fő bolt adja a törzsadatot, a többi onnan frissül. Nem kell kétszer karbantartani ugyanazt a katalógust.

Elérhető végpontok

Hitelesítés

Bearer token kérése a client_id és client_secret párossal.

  • POST/oauth/token

Termékek

Terméklista szűrőkkel (név, cikkszám, státusz, gyártó, kategória), és egy termék részletes adatai.

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

Kategóriák

Termékkategóriák listázása és egy kategória adatainak lekérése.

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

Gyártók

Gyártók listája kereséssel, és egy gyártó részletes adatai.

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

Termékparaméterek

A termékekhez tartozó paraméterértékek listázása.

  • GET/api/v2/product-parameters

Termékszűrők

A termékekhez rendelt szűrőértékek listázása.

  • GET/api/v2/product-filters

Rendelések

Rendelések listázása azonosító, státusz, e-mail vagy időszak szerint, és egy rendelés részletei.

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

AI

Szöveggenerálás a Sellvio AI-motorjával, közvetlenül a saját folyamatodból hívva.

  • POST/api/v2/ai/generate

REST · JSON · OAuth 2.0 · a bázis URL a saját boltod domainje · a listázó végpontok JSON, XLSX és CSV formátumban is válaszolnak

Indulás lépésről lépésre

1

Dokumentáció

Nyisd meg az API-referenciát, és nézd át a végpontokat, a kérés- és válaszformátumot.

2

API-kulcs

A hívások hitelesítéséhez API-kulcs szükséges, amelyet a Sellvio-fiókodhoz igényelhetsz.

3

Tesztelés

Próbáld ki a végpontokat élesítés előtt – a Postmanben egy kattintással futtathatod a kéréseket.

4

Élesítés

Kösd be az éles rendszered, és állítsd be a webhookokat a fontos eseményekre.

Építsd a saját folyamataidba

Kérdésed van a rate limitekről, az árazásról vagy az adatkezelésről? A fejlesztői csapatunk válaszol – fejlesztőknek, érthetően.

API-dokumentáció ↗EN

Az API-dokumentáció angol nyelvű.