Axnify
Pentru dezvoltatori

O platformă ecommerce împotriva căreia nu trebuie să lupți

Oprește-te din înșurubat workaround-uri pe un SaaS cutie-neagră. Axnify expune fiecare primitivă prin REST, livrează webhook-uri pentru fiecare eveniment și te lasă să editezi codul temei direct. Go în backend, Next.js în frontend, API-uri deschise peste tot.

De ce majoritatea platformelor ecommerce SaaS sunt ostile dezvoltatorilor

Alege oricare din top 10 platforme commerce SaaS și uită-te la documentația lor API. Apoi uită-te la admin UI-ul lor. Funcționalitățile nu se potrivesc. Adminul poate face lucruri pe care API-ul nu le poate. Mai rău, vendorul platformei știe asta — și consideră că e o feature, nu un bug. Blocarea capabilităților în spatele adminului este ceea ce te ține pe platforma lor. În momentul în care poți face totul prin API, poți și să pleci.

Aceasta este tensiunea fundamentală. Marile platforme SaaS (Shopify, BigCommerce, Wix Commerce) optimizează pentru comercianți non-tehnici pentru că aceștia formează majoritatea TAM-ului lor. Când dezvoltatorii cer un webhook pe un eveniment specific, o cale de a înregistra un pas de checkout custom, sau acces de scriere la o resursă anterior read-only, răspunsul este de obicei „upgrade la tier-ul enterprise” sau „folosește Zapier”.

Axnify este construită diferit pentru că backend-ul este structurat pentru asta. Fiecare domeniu este un microserviciu (product, order, cart, theme, billing, asset, customer, payment, shipping etc.) cu propria schemă de bază de date și propriul API HTTP. Admin UI-ul este un frontend care vorbește cu aceste API-uri — exact așa cum face codul tău. Nu există capabilitate admin-only. Nu există „endpoint intern” pe care să nu îl poți apela. Suprafața API-ului ESTE platforma.

Această decizie de design are consecințe. Înseamnă că Axnify este mai onestă despre ce suportă și ce nu: dacă nu este în API, nu există. Înseamnă că breaking change-urile sunt prinse mai rapid — nu poți lansa o feature de admin fără să lansezi și API-ul. Și înseamnă că tu, ca dezvoltator care integrează cu platforma, nu ești niciodată în poziția de a scrie un screen-scraper pentru că adminul poate face ceva ce codul tău nu poate.

De ce dezvoltatorii părăsesc marile platforme SaaS

API-uri read-only care nu se potrivesc cu admin UI

Poți lista produse, dar nu poți actualiza stocul; poți citi comenzi, dar nu poți umple un fulfillment din ERP-ul tău. Fiecare workaround devine o buclă Zapier, un export CSV manual sau un screen-scraper care se sparge în momentul în care platforma își reproiectează adminul.

Codul temei blocat în spatele tier-urilor enterprise

Shopify blochează editarea temei în Liquid + JS în spatele planului Plus de £2.300/lună. Vrei să atingi HTML-ul pe un plan de £29? Folosește drag-and-drop-ul lor, ca toți ceilalți. Wix nu expune codul temei pe niciun tier. BigCommerce stă la mijloc, dar taxează per-instance pentru editări de cod al temei.

Webhook-urile ratează evenimentele de care chiar ai nevoie

Platformele generice emit ~15 tipuri de webhook-uri. Evenimentul pe care îl vrei — pas de checkout completat, coș abandonat curățat, temă publicată, custom field actualizat, drept de app schimbat — de obicei nu este unul dintre ele. Ajungi să faci polling, ceea ce înseamnă dureri de cap cu rate-limit și date învechite.

Headless costă în plus și se sparge ușor

„Headless commerce” pe majoritatea platformelor înseamnă un SKU enterprise separat (Shopify Hydrogen, BigCommerce Stencil), o suprafață API diferită de cea pe care o folosește adminul standard, și zero paritate de documentație cu admin UI. Adesea API-ul headless este cu luni în urma adminului în acoperirea de feature-uri.

Ce primesc dezvoltatorii cu Axnify

API REST pentru fiecare primitivă

Produse, variante, stoc, clienți, comenzi, coșuri, teme, pagini, secțiuni, setări, webhook-uri, aplicații, fișiere, taxe — toate CRUD, totul documentat, totul în spatele unui singur token Bearer. Paginarea, filtrarea și sortarea urmează convenții consistente pe fiecare endpoint.

Webhook-uri pentru fiecare eveniment, pe fiecare plan

Comandă creată, plătită, îndeplinită, rambursată; coș creat / abandonat / recuperat; produs / variantă / stoc actualizat; temă publicată; staff invitat; aplicație instalată. Livrare webhook cu retry-uri (10 încercări în 48 de ore), semnături HMAC și un log de livrare în admin.

Editor de cod al temei integrat

Editează fișiere de temă (HTML / CSS / JS) direct în editorul de teme al adminului. Istoric versiuni la fiecare salvare. Preview înainte de publicare. Diff side-by-side față de ultima versiune publicată. Rollback într-un singur click dacă un deploy sparge ceva.

Headless-friendly implicit

Fiecare endpoint de storefront care servește commerce-ui-ul oficial returnează JSON prin API-ul public. Folosește Next.js, SvelteKit, Astro, sau propriul tău frontend custom care indică spre api.axnify.com. Același API alimentează storefront-ul nostru implicit — nu există o suprafață API headless de mâna a doua.

Marketplace de aplicații custom

Construiește o aplicație, listează-o pe marketplace, ia 80% revenue share. Înregistrare flow OAuth, permisiuni scoped, panouri UI încorporate în adminul comerciantului, abonamente webhook per instalare aplicație, dashboard-uri dedicate de aplicație pentru analitică de utilizare.

Multi-tenant din prima zi

Construit ca SaaS multi-tenant, nu ca o instalare single-store cu tenant_id lipit deasupra. Izolarea tenantului rulează prin policy-uri row-level security PostgreSQL, bucket-uri object-storage per tenant, namespace-uri Redis per tenant și rezolvare tenant per request în middleware-ul partajat.

Backend Go, stack modern

pgx, sqlc, Gin. PostgreSQL pentru stocare, Redis pentru caching, object-storage compatibil S3 pentru assets, Traefik pentru routing. Fără PHP, fără monolit Rails, fără monolit deloc — peste 20 de microservicii, fiecare deployabil independent, fiecare cu propriile migrări și teste.

API public stabil și versionat

Fiecare primitivă expusă prin REST pe api.axnify.com — produse, variante, stoc, comenzi, coșuri, teme, clienți, webhook-uri. Documentat, versionat și este aceeași suprafață pe care o apelează adminul oficial și storefront-urile. Fără endpoint-uri internal-only, fără tier headless de mâna a doua.

Cum diferă arhitectura Axnify de platformele commerce monolitice

Arhitectura clasică de platformă ecommerce — Shopify, Magento, WooCommerce — este o singură codebase monolitică care rulează împotriva unei singure baze de date. Asta face platforma rapidă de construit inițial și ușor de raționat pentru magazine mici. Înseamnă și că fiecare feature împarte același runtime, același pool de conexiuni la baza de date și același ciclu de release. Când echipa platformei livrează o nouă feature, fiecare comerciant o primește (sau bugul care a venit cu ea) în aceeași zi.

Axnify ia abordarea opusă. Fiecare domeniu commerce trăiește în propriul microserviciu Go. Serviciul product deține produsele, variantele, opțiunile și stocul. Serviciul order deține comenzile, line items și fulfillments. Serviciul cart deține coșurile active. Serviciul asset deține stocarea de fișiere. Serviciul theme deține temele, paginile, secțiunile și blocurile. În total sunt peste 20 de astfel de servicii, fiecare cu propria schemă PostgreSQL, propriul director de migrări, propriile teste, fiecare deployabil independent.

Serviciile comunică prin HTTP folosind autentificare internal-key pentru apeluri service-to-service și JWT/X-Tenant-ID pentru apeluri originate de utilizatorul final. Preocupările comune (auth, rezolvare tenant, rate limiting, logging, metrics, error tracking) trăiesc într-un pachet middleware partajat pe care fiecare serviciu îl importă. PostgreSQL este partajat dar schemele sunt izolate; un serviciu poate face JOIN împotriva tabelelor altuia prin views, dar scrierile trec prin API-ul serviciului proprietar.

Pentru tine ca dezvoltator care integrează cu platforma, această arhitectură are implicații practice. API-urile sunt stabile per-serviciu: API-ul product evoluează în propriul ritm, API-ul order în al său. Webhook-urile vin de la serviciul care deține evenimentul, cu metadate bogate despre ce serviciu a emis ce. Performanța este limitată per-domeniu: un query lent de raport în serviciul de analytics nu poate bloca apelul tău de order-create. Și debugging-ul este mai ușor pentru că fiecare request poartă un request ID logat în fiecare serviciu pe care îl atinge.

Ce construiesc dezvoltatorii pe Axnify

Flow-uri de checkout custom

Sari peste checkout-ul implicit complet. Conduce un checkout React/Vue custom din API-urile cart și payment în timp ce încă folosești Axnify pentru stoc, taxe și fulfillment în aval. API-ul cart îți dă control total asupra a ce se întâmplă la fiecare pas.

Integrări ERP / OMS

Sync bidirecțional cu NetSuite, SAP B1, Dynamics 365. Actualizările incrementale webhook-driven împing comenzile noi în ERP-ul tău în timp real; endpoint-uri REST bulk gestionează reconcilierile nocturne. Chei de idempotență pe fiecare scriere astfel încât retry-urile să fie sigure.

Unelte interne ale comerciantului

Construiește panouri admin pe care echipa ta CS chiar vrea să le folosească. Folosește token-uri API staff cu permisiuni scoped; adminul comerciantului și uneltele tale custom coexistă. View-uri read-only pot fi acordate suportului care nu ar trebui să aibă acces admin complet.

Deployment-uri multi-frontend

Același catalog de produse, multiple storefront-uri (web, app mobil, kiosk în magazin, asistent vocal). Fiecare consumă același API; Axnify este sursa de adevăr. Evenimente de invalidare a cache-ului se declanșează când un produs se schimbă astfel încât fiecare frontend să poată re-fetcha datele.

Întrebări comune de la dezvoltatori

Există un API GraphQL?

Doar REST astăzi. Am cântărit GraphQL în timpul arhitecturii și am ales REST pentru cacheability (semantică HTTP, CDN-friendly), librării client mai simple și debugging mai ușor. Dacă GraphQL este o cerință dură pentru echipa ta, Saleor sau Vendure sunt alegeri mai bune astăzi.

Care sunt rate limits ale API-ului?

1.000 req/min per token API pe Starter, 10.000 pe Pro, nelimitat (doar fair-use) pe Business+. Endpoint-urile bulk (ex. import produse) sunt scutite de capul per minut și rate-limited după byte-uri totale pe oră în schimb. Header-ele rate-limit (`X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`) sunt returnate la fiecare răspuns.

Este Axnify open source sau self-hostable?

Nu — Axnify este un SaaS complet managed. Noi rulăm și operăm platforma astfel încât tu să te poți concentra pe construirea magazinului tău și a integrărilor tale. Fiecare capabilitate este expusă prin API-ul REST public și webhook-uri pe api.axnify.com, deci nu ai nevoie de acces server pentru a o extinde sau integra.

Cum sunt plătite abonamentele de aplicații?

Clientul se abonează prin adminul comerciantului → Stripe gestionează billing-ul → Axnify ia 20% comision de platformă → 80% se plătește în contul tău Stripe conectat săptămânal. Rambursările și chargeback-urile se întorc pe același drum. Dezvoltatorii de aplicații își văd veniturile într-un dashboard dedicat cu istoric de plăți.

Cum mă autentific față de API?

Creează un Personal Access Token în admin sub Developers → API tokens. Trimite-l ca `Authorization: Bearer <token>` la fiecare request. Token-urile poartă permisiuni scoped (read-only, read-write, admin), expiră după un program pe care îl alegi, și pot fi revocate instant de pe același ecran.

În ce limbaj / framework sunt scrise temele?

Temele sunt arbori de blocuri definiți în JSON randați de un renderer TypeScript partajat (commerce-ui). Librăria de blocuri implicită acoperă ~40 de tipuri de widget; poți livra widget-uri custom scriind un component React și înregistrându-l prin aplicație. Codul temei este editabil per-comerciant în editorul de teme al adminului.

Mă puteți ajuta să-mi mut datele de pe altă platformă?

Absolut. Scrieți la support@axnify.com cu fișierul de export de pe platforma curentă — acceptăm Shopify, WooCommerce, Etsy, Squarespace, Big Cartel, Gumroad, Sellfy și majoritatea altor formate comune. Echipa noastră gestionează migrarea produselor, variantelor, clienților și comenzilor tale end-to-end, gratis pentru importuri standard.

Oprește-te din lupta cu platforma ta ecommerce

Înregistrează-te gratuit, primește un token API în 60 de secunde, începe să integrezi.