Fiecare Fabrixa și SKU, fiecare material, fiecare finisaj — accesibile printr-un singur REST API documentat. Intrare JSON, ieșire JSON. Webhooks pentru fiecare tranziție de stare. Chei API cu acces autonom — creați un canal de vânzări și începeți să construiți.
Un REST API documentat care reflectă funcționalitatea platformei — comenzi, procesarea comenzilor, personalizarea Studio și webhook-uri. Intrare JSON, ieșire JSON. Utilizați-l împreună cu tabloul de bord sau controlați totul prin programare.
Trimiteți o comandă care să conțină rânduri, fișiere PDF sursă, detaliile clientului și adresa de livrare. Se returnează ID-ul comenzii Fabrixa. Câmpurile pentru eticheta de expediere și urmărirea comenzii sunt opționale.
Afișează starea de producție pentru fiecare articol în parte: fiecare etapă (imprimare, reparare, spălare, cusut) cu stările „în așteptare”, „în curs”, „finalizată” sau „respinsă”. Sau abonează-te la webhooks pentru notificări push.
Incorporează Fabrixa Studio în vitrina magazinului dumneavoastră. Clienții pot personaliza produsele în timp real, cu ajutorul evenimentelor postMessage pentru adăugarea în coș și revenirea la pagina anterioară, precum și al unei adrese URL de previzualizare pentru miniaturile din coș.
Două subiecte: încărcături semnate cu HMAC-SHA256, corp de comandă complet, livrare cu 10 încercări de repetare și interval de așteptare.
Cerere autentificată, conținut validat, loc rezervat în coada de așteptare de producție. Confirmare primită în câteva milisecunde — comanda clientului dumneavoastră este acum în curs de procesare.
Schema completă, toate punctele de interfață, codurile de eroare, limitele de rată și exemplele de integrare se regăsesc în documentația tehnică.
// POST https://api.fabrixa.com/v2/integration/orders // Authorization: Bearer APPLICATION_ACCESS_TOKEN // X-Application-Key: APPLICATION_KEY { "number": "ORD-2026-0142", "purchased_at": "2026-05-28 14:22:01", "rows": [ { "sku": "COF099191", "quantity": 1, "sources": [ { "type": "file", "url": "https://cdn.you.com/art/9812.pdf" } ] } ], "customer": { "first_name": "Maria", "last_name": "Silva", "email": "maria@example.com", "phone": "+351912345678" }, "shipping_address": { "address": "Rua do Carmo 42", "city": "Lisboa", "postal_code": "1200-094", "country_code": "PT", "country": "Portugal" } }
Integrare REST directă în platforma dumneavoastră. Nu este necesar niciun SDK, niciun server proxy și niciun conector terț. Protocol HTTP standard de la stiva dumneavoastră la a noastră.
Obțineți un token de acces pentru aplicație și o cheie de aplicație prin crearea unui canal de vânzări în tabloul de bord. Ambele sunt necesare pentru fiecare solicitare: tokenul „Bearer” în autorizare, iar cheia de aplicație în câmpul „X-Application-Key”.
Răsfoiți referința Swagger în timp real pentru a găsi variantele SKUs ale produselor pe care doriți să le vindeți, precum și modelele de filtrare și paginare.
La finalizarea comenzii, trimiteți o solicitare POST conținând rândurile, sursele (URL-urile PDF-urilor), datele clientului și adresa de livrare. Salvați ID-ul comenzii Fabrixa primit împreună cu propria referință a comenzii.
Puneți la dispoziție un punct final public de tip POST. Semnăm fiecare încărcătură cu HMAC-SHA256 (x-webhook-signature), astfel încât să puteți verifica autenticitatea înainte de procesare.
Opțional: inserați iframe-ul Fabrixa Studio în pagina produsului. Clienții își personalizează produsul în timp real; personalizările lor sunt atașate comenzii prin POST.
Documentație completă privind punctele de capăt, scheme de solicitare/răspuns, coduri de eroare, limite de rată, autentificare, integrare în Studio și contracte webhook — cu o interfață Swagger în timp real.
Deschide documentele →Creați un canal de vânzări dedicat pe care să vă bazați — trimiteți comenzi de test, verificați livrarea webhook-urilor, validați cazurile limită — apoi direcționați traficul real către canalul dvs. activ. Cheile dvs. sunt gata din momentul în care creați canalul — fără a fi necesară o etapă de solicitare.
Creează-ți contul →Colecție de solicitări preconfigurate, cu exemple de date de încărcare și autentificare. Importați-o în fluxul dvs. de lucru de testare.
Descoperă colecția →Practici standard, fără surprize. Fiecare solicitare este autentificată atât cu un token „Bearer”, cât și cu o cheie de aplicație. Fiecare webhook este semnat HMAC în scopul verificării, cu limite de rată previzibile pentru fiecare aplicație.
Tokenul „Bearer” din antetul „Authorization”. Identifică aplicația care efectuează apelul.
Se trimit în antetul X-Application-Key. Ambele sunt obligatorii pentru fiecare cerere — lipsa oricăreia dintre ele generează un cod de eroare 401.
Pe api.fabrixa.com se acceptă doar HTTPS. Cererile în text simplu sunt respinse la nivelul punctului de acces.
Fiecare webhook este semnat cu HMAC-SHA256, semnătura fiind transmisă în antetul x-webhook-signature. Verificați-o înainte de procesare.
30 de solicitări pe aplicație pe minut. În fiecare răspuns sunt returnate valorile X-RateLimit-Limit și X-RateLimit-Remaining.
Se efectuează până la 10 încercări de livrare în cazul unui răspuns care nu este de tip 2xx sau 3xx. Webhook-ul este dezactivat după cea de-a 10-a încercare eșuată.
Fiecare cerere necesită două antete: un token de acces al aplicației, trimis ca token „Bearer” în antetul „Authorization”, și o cheie a aplicației în antetul „X-Application-Key”. Ambele sunt generate în momentul în care creați un canal de vânzări în tabloul de bord Fabrixa, iar o cerere este respinsă cu codul de eroare 401 dacă lipsește vreunul dintre aceste antete.
Da — creați un canal de vânzări dedicat pe care să construiți, trimiteți comenzi de test, verificați livrarea webhook-urilor și validați cazurile marginale, apoi direcționați traficul real către canalul dvs. activ odată ce acesta funcționează. Înregistrarea și crearea acestui canal fac ca tokenul de acces al aplicației și cheia aplicației să fie disponibile imediat, fără a fi necesară o etapă separată de solicitare.
Da — serviciul API funcționează exclusiv prin HTTPS pe api.fabrixa.com, iar orice cerere în text simplu este respinsă la nivelul punctului de acces. De asemenea, fiecare cerere este autentificată atât cu un token Bearer, cât și cu o cheie de aplicație, iar fiecare încărcătură a unui webhook este semnată cu HMAC-SHA256, astfel încât să poată fi verificată înainte de procesare.
O solicitare POST autentificată către /v2/integration/orders validează conținutul, rezervă un loc în coada de așteptare de producție și returnează o confirmare cu ID-ul comenzii Fabrixa exprimat în milisecunde, împreună cu câmpuri opționale pentru eticheta de expediere și urmărire. Ulterior, procesul de îndeplinire a comenzii poate fi urmărit pentru fiecare articol în parte sau vă poate fi transmis prin intermediul webhook-urilor.
Nu — Integrarea fabrixa se realizează printr-o conexiune REST directă prin HTTP standard, fără a fi necesar un SDK, un server proxy sau un conector terț. Puteți apela fabrixa direct din propria dvs. stivă de tehnologii folosind cereri și răspunsuri JSON, cu webhook-uri pentru modificările de stare.
Înregistrați-vă, creați un canal de vânzări, iar datele de autentificare pentru API vor fi disponibile imediat. Aveți nevoie de ajutor? Inginerii noștri de soluții vă răspund în termen de 24 de ore — majoritatea echipelor sunt operaționale în două săptămâni.
Resurse pentru dezvoltatori: Documentația API https://www.fabrixa.com/developers/api-documentation · Ghid de integrare https://www.fabrixa.com/developers/integration-guide/ · Webhooks https://api.fabrixa.com/docs/integration#webhooks
Citește răspunsul →Fiecare comandă are o listă de expedieri, returnată prin GET /orders/{id} și în notificarea order.updated, care se declanșează de fiecare dată când se modifică starea sau informațiile de urmărire ale unei expedieri.
Citește răspunsul →Vă puteți conecta prin intermediul interfeței noastre REST API și al unui feed de produse, iar Fabrixa Studio, editorul nostru de design, poate fi integrat în propria dvs. platformă, astfel încât să apară ca o funcționalitate proprie.
Citește răspunsul →Toate cele 8 răspunsuri la „Integrări” și „API” → Contactează echipa noastră de asistență →
