Axnify
Fejlesztőknek

Egy ecommerce platform, amivel nem kell harcolnod

Hagyd abba a workaround-ok rácsavarozását egy fekete-doboz SaaS-re. Az Axnify minden primitívet REST-en keresztül kitesz, minden eseményre webhookot küld, és engedi, hogy közvetlenül szerkeszd a témakódot. Go a backenden, Next.js a frontenden, nyitott API-k mindenhol.

Miért ellenségesek a legtöbb ecommerce SaaS platformok a fejlesztőkkel

Válassz ki bármelyiket a top 10 commerce SaaS platform közül, és nézd meg az API dokumentációjukat. Aztán nézd meg az admin UI-t. A funkciók nem egyeznek. Az admin tud olyan dolgokat, amiket az API nem. Rosszabb, a platform szállítója ezt tudja — és ezt feature-nek tartja, nem bugnak. A képességek admin mögé zárása az, ami a platformjukon tart téged. Abban a pillanatban, hogy mindent meg tudsz csinálni API-n keresztül, el is mehetsz.

Ez a fundamentális feszültség. A nagy SaaS platformok (Shopify, BigCommerce, Wix Commerce) nem-műszaki kereskedőkre optimalizálnak, mert ők alkotják a TAM nagyobb részét. Amikor fejlesztők egy konkrét eseményre webhookot kérnek, egy módot egyedi checkout-lépés regisztrálására, vagy írási hozzáférést egy korábban csak olvasható erőforráshoz, a válasz általában „lépj enterprise tier-re” vagy „használj Zapier-t”.

Az Axnify máshogy épült, mert a backendje erre van strukturálva. Minden domain egy mikroszerviz (product, order, cart, theme, billing, asset, customer, payment, shipping stb.) saját adatbázis-sémával és saját HTTP API-val. Az admin UI egy frontend, ami ezekkel az API-kkal beszél — pontosan úgy, ahogy a kódod. Nincs admin-only képesség. Nincs „belső endpoint”, amit ne tudnál meghívni. Az API felülete A platform.

Ennek a tervezési döntésnek vannak következményei. Azt jelenti, hogy az Axnify őszintébb arról, mit támogat és mit nem: ha nincs az API-ban, nem létezik. Azt jelenti, hogy a breaking change-eket gyorsabban elkapják — nem tudsz admin feature-t kiszállítani anélkül, hogy API-t is szállítanál. És azt jelenti, hogy te, mint fejlesztő, aki a platformhoz integrálódik, sosem leszel abban a helyzetben, hogy screen-scrapert kelljen írnod, mert az admin tud valamit, amit a kódod nem.

Miért hagyják el a fejlesztők a nagy SaaS platformokat

Read-only API-k, amik nem egyeznek az admin UI-val

Tudsz termékeket listázni, de nem tudsz készletet frissíteni; tudsz rendeléseket olvasni, de nem tudsz fulfillmentet visszatölteni az ERP-edből. Minden workaround Zapier ciklussá, kézi CSV exporttá vagy screen-scraperré válik, ami eltörik abban a pillanatban, amikor a platform újratervezi az admin-t.

Témakód enterprise tier-ek mögé zárva

A Shopify a Liquid + JS téma-szerkesztést £2 300/hó Plus terv mögé zárja. HTML-hez akarsz nyúlni egy £29-es terven? Használd a drag-and-drop-jukat, mint mindenki más. A Wix semmilyen tier-en nem teszi elérhetővé a témakódot. A BigCommerce középen ül, de instance-onként számláz a témakód-szerkesztésekért.

A webhookok lemaradnak az eseményekről, amikre tényleg szükséged van

Az általános platformok ~15 típusú webhookot bocsátanak ki. Az esemény, amit akarsz — checkout-lépés befejezve, elhagyott kosár kiürítve, téma publikálva, custom field frissítve, app jogosultság megváltozott — általában nincs köztük. Pollingra kényszerülsz, ami rate-limit fejfájást és elavult adatokat jelent.

A headless extra pénzbe kerül és könnyen eltörik

A „headless commerce” a legtöbb platformon külön enterprise SKU-t jelent (Shopify Hydrogen, BigCommerce Stencil), eltérő API felületet attól, amit a standard admin használ, és nulla dokumentációs paritást az admin UI-val. Gyakran a headless API hónapokkal le van maradva az admintól funkció lefedettségben.

Mit kapnak a fejlesztők az Axnify-jal

REST API minden primitívhez

Termékek, variánsok, készlet, ügyfelek, rendelések, kosarak, témák, oldalak, szekciók, beállítások, webhookok, appok, fájlok, adók — minden CRUD, minden dokumentálva, minden egyetlen Bearer token mögött. A lapozás, szűrés és rendezés konzisztens konvenciókat követ minden endpointon.

Webhookok minden eseményhez, minden terven

Rendelés létrehozva, fizetve, teljesítve, visszatérítve; kosár létrehozva / elhagyva / visszaállítva; termék / variáns / készlet frissítve; téma publikálva; staff meghívva; app telepítve. Webhook kézbesítés retry-jel (10 próbálkozás 48 óra alatt), HMAC aláírásokkal és kézbesítési loggal az adminban.

Beépített témakód-szerkesztő

Szerkeszd a témafájlokat (HTML / CSS / JS) közvetlenül az admin témaszerkesztőjében. Verziótörténet minden mentésre. Előnézet publikálás előtt. Side-by-side diff a legutóbb publikált verzióval. Egy kattintással visszagörgetés, ha egy deploy eltör valamit.

Alapból headless-barát

Minden storefront endpoint, amely a hivatalos commerce-ui-t szolgálja ki, JSON-t ad vissza a nyilvános API-n keresztül. Használj Next.js-t, SvelteKit-et, Astrót, vagy saját custom frontendet, ami az api.axnify.com-ra mutat. Ugyanaz az API hajtja az alapértelmezett storefrontunkat — nincs másodosztályú headless API felület.

Egyedi appok marketplace-e

Építs egy appot, listázd a marketplace-en, vidd el a 80% revenue share-t. OAuth-flow regisztráció, scoped jogosultságok, beágyazott UI panelek a kereskedő adminban, webhook előfizetések app-telepítésenként, dedikált app dashboardok használati analitikához.

Multi-tenant az első naptól

Multi-tenant SaaS-ként épült, nem egy single-store telepítés tenant_id-vel rátűzve. A tenant izoláció PostgreSQL row-level security policy-kon, per-tenant object-storage bucket-eken, per-tenant Redis namespace-eken és per-request tenant feloldáson keresztül fut megosztott middleware-ben.

Go backend, modern stack

pgx, sqlc, Gin. PostgreSQL tárolásra, Redis cache-elésre, S3-kompatibilis object-storage assetekre, Traefik routingra. Nincs PHP, nincs Rails monolit, egyáltalán nincs monolit — több mint 20 mikroszerviz, mindegyik függetlenül deployolható, mindegyik saját migrációkkal és tesztekkel.

Stabil, verziózott nyilvános API

Minden primitív REST-en keresztül kitéve az api.axnify.com-on — termékek, variánsok, készlet, rendelések, kosarak, témák, ügyfelek, webhookok. Dokumentálva, verziózva, és ez ugyanaz a felület, amit a hivatalos admin és a storefrontok hívnak. Nincsenek internal-only endpointok, nincs másodosztályú headless tier.

Miben különbözik az Axnify architektúrája a monolit commerce platformoktól

A klasszikus ecommerce platform architektúra — Shopify, Magento, WooCommerce — egyetlen monolit codebase, ami egyetlen adatbázis ellen fut. Ez teszi a platformot gyorsan építhetővé kezdetben és könnyen átláthatóvá kis boltoknál. Azt is jelenti, hogy minden feature ugyanazt a runtime-ot, ugyanazt az adatbázis connection pool-t és ugyanazt a release ciklust osztja. Amikor a platform csapat új feature-t szállít, minden kereskedő megkapja (vagy a bugot, ami vele jött) ugyanazon a napon.

Az Axnify ellentétes megközelítést választ. Minden commerce domain saját Go mikroszervizben él. A product szerviz tulajdonolja a termékeket, variánsokat, opciókat és készletet. Az order szerviz tulajdonolja a rendeléseket, line itemeket és fulfillmenteket. A cart szerviz tulajdonolja az aktív kosarakat. Az asset szerviz tulajdonolja a fájltárolást. A theme szerviz tulajdonolja a témákat, oldalakat, szekciókat és blokkokat. Összesen több mint 20 ilyen szerviz van, mindegyik saját PostgreSQL sémával, saját migrációs könyvtárral, saját tesztekkel, mindegyik függetlenül deployolható.

A szervizek HTTP-n keresztül kommunikálnak internal-key autentikációval service-to-service hívásokhoz és JWT/X-Tenant-ID-val végfelhasználói eredetű hívásokhoz. A megosztott gondok (auth, tenant feloldás, rate limiting, logging, metrikák, error tracking) egy megosztott middleware csomagban élnek, amit minden szerviz importál. A PostgreSQL megosztott, de a sémák izoláltak; egy szerviz JOIN-olhat egy másik tábláihoz views-on keresztül, de az írások a tulajdonos szerviz API-ján mennek át.

Számodra mint a platformhoz integrálódó fejlesztő számára ennek az architektúrának praktikus következményei vannak. Az API-k per-szerviz stabilak: a product API saját ütemben fejlődik, az order API a sajátjában. A webhookok az eseményt tulajdonló szervizből jönnek, gazdag metaadatokkal arról, melyik szerviz mit bocsátott ki. A teljesítmény per-domain korlátozott: egy lassú jelentés lekérdezés az analytics szervizben nem tudja blokkolni az order-create hívásodat. És a debug egyszerűbb, mert minden request request ID-t hordoz, amit minden megérintett szervizben logolnak.

Mit építenek a fejlesztők Axnify-ra

Egyedi checkout flowok

Hagyd ki az alapértelmezett checkoutot teljesen. Vezess egyedi React/Vue checkoutot a cart és payment API-kból, miközben még mindig használod az Axnifyt készletre, adóra és fulfillmentre lefelé. A cart API teljes kontrollt ad afölött, mi történik minden lépésnél.

ERP / OMS integrációk

Kétirányú szinkron NetSuite, SAP B1, Dynamics 365 rendszerrel. Webhook-vezérelt inkrementális frissítések pusholják az új rendeléseket az ERP-edbe valós időben; bulk REST endpointok kezelik az éjszakai egyeztetéseket. Idempotency kulcsok minden íráson, hogy a retry-k biztonságosak legyenek.

Belső kereskedői eszközök

Építs admin paneleket, amiket a CS csapatod tényleg használni akar. Használj staff API tokeneket scoped jogosultságokkal; a kereskedő admin és a saját egyedi eszközeid együtt léteznek. Read-only nézeteket lehet adni a támogatásnak, akinek nem kellene teljes admin hozzáférést kapnia.

Multi-frontend deployok

Ugyanaz a termékkatalógus, több storefront (web, mobil app, in-store kiosk, hangsegéd). Mindegyik ugyanazt az API-t fogyasztja; az Axnify az igazság forrása. Cache invalidation események sülnek el, amikor egy termék változik, hogy minden frontend újrahúzhassa az adatokat.

Gyakori kérdések fejlesztőktől

Van GraphQL API?

Ma csak REST. GraphQL-t mérlegeltük az architektúra során, és a REST-et választottuk a cacheability (HTTP szemantika, CDN-barát), egyszerűbb kliens könyvtárak és könnyebb debug miatt. Ha a GraphQL kemény követelmény a csapatodnak, a Saleor vagy a Vendure jobb választás ma.

Mik az API rate limitjei?

1 000 req/perc API tokenenként Starteren, 10 000 Pro-n, korlátlan (csak fair-use) Business+-on. A bulk endpointok (pl. termékimport) mentesülnek a percenkénti cap alól, és helyette teljes byte-ban óránként vannak rate-limitelve. A rate-limit headerek (`X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`) minden válaszra visszaadásra kerülnek.

Az Axnify open source vagy self-hostable?

Nem — az Axnify teljesen managed SaaS. Mi futtatjuk és üzemeltetjük a platformot, hogy te a boltod és integrációd építésére koncentrálhass. Minden képesség elérhető a nyilvános REST API-n és webhookokon keresztül az api.axnify.com-on, így nincs szükséged szerver-hozzáférésre a kiterjesztéséhez vagy integrálásához.

Hogyan vannak fizetve az app előfizetések?

Ügyfél előfizet a kereskedő adminon keresztül → Stripe kezeli a billinget → Axnify 20% platformdíjat vesz → 80% kifizetődik a csatlakoztatott Stripe fiókodba hetente. Visszatérítések és chargebackek ugyanazon az úton mennek vissza. Az app fejlesztők bevételeiket dedikált dashboardon látják kifizetési előzményekkel.

Hogyan autentikáljak az API ellen?

Hozz létre Personal Access Tokent az adminban a Developers → API tokens alatt. Add át mint `Authorization: Bearer <token>` minden requestben. A tokenek scoped jogosultságokat hordoznak (read-only, read-write, admin), az általad választott ütemezés szerint lejárnak, és azonnal visszavonhatók ugyanarról a képernyőről.

Milyen nyelven / frameworkben íródnak a témák?

A témák JSON-definiált blokk-fák, amiket egy megosztott TypeScript renderer (commerce-ui) renderel. Az alapértelmezett blokk könyvtár ~40 widget típust fed le; egyedi widgeteket szállíthatsz React komponens írásával és app-on keresztüli regisztrálásával. A témakód kereskedőnként szerkeszthető az admin témaszerkesztőjében.

Tudtok segíteni az adataim átvitelében egy másik platformról?

Mindenképp. Írj a support@axnify.com-ra a jelenlegi platformod export fájljával — elfogadjuk a Shopify, WooCommerce, Etsy, Squarespace, Big Cartel, Gumroad, Sellfy és a legtöbb más gyakori formátumot. A csapatunk kezeli a termékeid, variánsaid, ügyfeleid és rendeléseid migrációját end-to-end, ingyen standard importokhoz.

Hagyd abba a harcot az ecommerce platformoddal

Regisztrálj ingyen, kapj API tokent 60 másodperc alatt, kezdj integrálni.