VALÓS IDEJŰ KÉSZLETKEZELŐ API
REST API és eseménybusz, amely a raktárát készletszinkronban tartja a 888 Wholesale-lel.Élő készlet lekérdezése, atomi tranzakciók rögzítése, aláírt webhookok regisztrálása, és automatikus utántöltési jelzés a küszöbértékek alapján. ERP-khez, 3PL-ekhez, Shopify-hoz és saját üzemeltetéshez.
EGY FŐKÖNYV. MINDEN RAKTÁR.
A feldolgozás négy független útvonalra válik szét: készletolvasás, tranzakcióírás, riasztáskiértékelés és webhook-kézbesítés. Az olvasás soha nem blokkolja az írást, az írás pedig soha nem blokkolja a kézbesítést, így a terhelt eseménybusz nem lassítja a készletlekérdezést.
Olvasási késleltetés (99. percentilis)
< 40ms
Idempotencia-ablak
24h
Eseményaláírás
HMAC-256
Rendelkezésre állási cél
99.9%
KIS FELÜLET. TELJES KONTROLL.
Minden raktár együtt mozog a 888-cal: nincs túlértékesítés, nincs váratlan készlethiány. Néhány erőforrás lefedi a teljes életciklust. Készlet lekérdezése, tranzakciók rögzítése, riasztások figyelése, eseményekre feliratkozás. Bearer-token hitelesítés, JSON be, JSON ki.
/v1/stockÉlő készletszintek és státusz (OK, LOW, CRITICAL) lekérdezése egy vagy több SKU-ra a raktárában.
curl -H "Authorization: Bearer $WMS_KEY" https://www.888wholesale.co/api/wms/v1/stock?sku=TEE-BLK-L
/v1/stock/updateAláírt készletváltozások (eladás, visszavét, sérülés, korrekció) atomi feldolgozása kötegelten. Idempotency-Key kulccsal biztonságos.
curl -X POST -H "Authorization: Bearer $WMS_KEY" -H "Idempotency-Key: $(uuidgen)" -d '{"transactions":[{"sku":"TEE-BLK-L","delta":-12,"type":"SALE"}]}' https://www.888wholesale.co/api/wms/v1/stock/update/v1/alertsNyitott utántöltési riasztások listázása, amelyek akkor keletkeznek, ha egy SKU eléri vagy átlépi az utántöltési küszöböt.
curl -H "Authorization: Bearer $WMS_KEY" https://www.888wholesale.co/api/wms/v1/alerts
/v1/webhooksAláírt HTTPS visszahívás regisztrálása az alert.triggered, order.shipped és order.delivered eseményekre.
curl -X POST -H "Authorization: Bearer $WMS_KEY" -d '{"url":"https://erp.example.com/hooks","events":["alert.triggered"]}' https://www.888wholesale.co/api/wms/v1/webhooksÜGYFÉLRAKTÁRAKRA TERVEZVE
Valós idejű készlet
A szintek és a státusz a commit pillanatában íródnak, és élőben olvashatók vissza. Nincs gyorsítótár a kliens és a valós adat között.
Küszöbriasztások
SKU-szintű utántöltési küszöbök és céllétszámok automatikusan CRITICAL és LOW jelzést adnak az utántöltéshez.
Aláírt webhookok
HMAC-aláírt események riasztásokról és szállítmányokról, amelyeket beérkezéskor ellenőriz, majd az API-val egyeztet.
Hatókörös tokenek
Raktáranként kiadott tokenek supervisor vagy worker jogosultsággal. Alapértelmezetten minimális jogosultság, egy kattintással visszavonható.
Csak bővülő főkönyv
Minden eladás, visszavét, korrekció és bevételezés rögzül típussal, művelet utáni mennyiséggel, forrással és időbélyeggel.
Idempotens írások
A kliens által küldött kulcsok 24 órás ablakban kiszűrik az újraküldött írásokat, így a rendszerei biztonságosan ismételhetnek.
KÉRDÉSEK ÉS VÁLASZOK
Gyakori kérdések szolgáltatásainkról, a rendelési folyamatról és a partnerségi feltételekről.
Minden végpont Bearer token hitelesítést használ. Egy token egyetlen raktárra érvényes, és vagy supervisor jogosultságot hordoz (olvasás és írás), vagy worker jogosultságot (csak olvasható készlet és a saját kiadási előzményei). A tokenek a portál hitelesítő adataiból készülnek, és bármikor visszavonhatók vagy újra kiadhatók a portálon a Raktár, API kulcsok menüpont alatt.
A készletváltozások a commit pillanatában szinkron módon íródnak, és a következő GET /v1/stock híváskor már láthatók. Kezelje a REST végpontokat elsődleges forrásként: kérdezze le őket saját ütemezés szerint, a webhookokat pedig gyors értesítési rétegként használja fölöttük.
Igen. Minden raktár külön egység, saját SKU-nyilvántartással, készletszintekkel és tokenkészlettel. Egy fiók több raktárat is üzemeltethet a portálról, és minden raktárhoz több hatókörös token tartozhat, például integrációnként egy, plusz worker-eszközönként egy.
A küszöböket és a céllétszámokat a 888 Wholesale állítja be. Amikor először érkezik szállítmány a raktárába, az érintett SKU-k automatikusan inicializálódnak észszerű céllétszámmal és küszöbbel, amit ezután felülvizsgálunk. Ha módosítást szeretne, jelezze a 888-as kapcsolattartójánál. A partnerek nem regisztrálnak SKU-t maguknak.
Igen. Minden kézbesítés tartalmaz egy X-WMS-Signature fejlécet sha256=<hex> formában, amely a kérés pontos törzsének HMAC-SHA256 aláírása a webhook regisztrálásakor kapott titokkal. Számolja újra a szerverén, és időzítésbiztos összehasonlítással ellenőrizze, mielőtt bármely üzenetet elfogad.
A webhookok legjobb szándékú értesítések. Minden esemény egyszer kerül kézbesítésre rövid időkorláttal, ezért a fogadóoldalt idempotensre érdemes építeni, és a GET végpontokkal (készlet, riasztások, szállítmányok) mint mérvadó állapottal egyeztetni. Egy kimaradt webhook soha nem jelent kimaradt adatot: az adat mindig elérhető az API-n keresztül.
Állítsa a klienst az éles alap-URL-re, és ellenőrizze az elérhetőséget a hitelesítés nélküli GET /v1/health végponttal. Készítsen tokent, majd futtassa végig a folyamatot egy dedikált teszt-SKU-n és teszt-raktáron, így olvashat, írhat és egyeztethet anélkül, hogy éles programokhoz nyúlna. Az idempotencia-kulcsok minden írást biztonságosan ismételhetővé tesznek a tesztelés során.
Küldjön Idempotency-Key fejlécet (bármilyen egyedi karakterlánc, jellemzően UUID) a POST /v1/stock/update vagy a POST /v1/transactions híváson. Ha ugyanaz a kulcs 24 órán belül újra megérkezik, a szerver az eredeti választ játssza vissza a változás ismételt alkalmazása nélkül, így egy megszakadt kapcsolat utáni újrapróbálkozás soha nem duplázhat.
További kérdése van?
Vegye fel a kapcsolatot csapatunkkal itt: info@888wholesale.co, vagy hívjon minket nyitvatartási időben.
API kulcs igénylése
KÖSSE BE A RAKTÁRÁT. INDULHAT A SZÁLLÍTÁS.
A jóváhagyott ügyfelek a portálról regisztrálhatnak raktárat, készíthetnek hatókörös tokent, és megkezdhetik a készletszinkront. Egyedi integrációra van szüksége? Egyeztessen konzultációt.