Serviciul de tipărire la cerere Fabrixa API permite oricărei platforme sau magazine online POD să trimită o comandă și să îi urmărească ciclul de viață prin order.created și order.updated webhooks, iar Fabrixa se ocupă de imprimare, ambalare și expediere sub marcă albă — începând de la o singură bucată, în toată UE. Dumneavoastră creezi experiența de cumpărare; noi ne ocupăm de producția textilă adaptată la cerere. Fără comandă minimă, fără taxe de configurare, fără marca Fabrixa pe colet.
Această postare reprezintă o prezentare generală, redactată într-un limbaj simplu, a integrării API (v2), destinată dezvoltatorilor care evaluează Fabrixa ca strat de îndeplinire a comenzilor. Dacă doriți să parcurgeți rapid documentul de referință, versiunea completă Documentația API și pas cu pas ghid de integrare suntem gata când sunteți și dumneavoastră.
La ce servește API
Fabrixa este un platformă de imprimare reactivă pe textile: un singur panou de control pentru canalele de vânzare, design, producție și expediere. Majoritatea clienților se conectează prin Shopify, WooCommerce sau Fabrixa Studio. Integrarea API reprezintă a patra opțiune — concepută pentru platformele POD și pentru dezvoltatorii care dețin deja propriul magazin online și doresc să aibă control programatic asupra procesului de îndeplinire a comenzilor.
Voi contactați API pentru a transmite comenzile. Fabrixa se ocupă de producție: imprimare reactivă pe bumbac și in în Portugalia și Spania, imprimare prin sublimare pe poliester în Olanda. Coletele sunt expediate sub marca voastră, cu adresa voastră de retur, fără ca pe ambalaj să apară vreo mențiune referitoare la Fabrixa. Clienții voștri nu vor afla niciodată de existența noastră, decât dacă le spuneți voi.
Ce face API
- Ping — o verificare rapidă pentru a te asigura că datele de autentificare și conexiunea sunt active înainte de a trimite orice informație reală.
- Produse — consultați catalogul pe care îl creați: îmbrăcăminte, textile pentru casă și țesături la metru, cu modelele de bază și variantele disponibile pentru imprimare.
- Comenzi — crearea unei comenzi și verificarea stării acesteia. Acesta este elementul central al oricărei integrări: se introduc rânduri, surse, detalii despre client și livrare; se obține o comandă cu urmărire.
- Îndepliniri — urmăriți procesul de producție și expediere pe măsură ce articolele sunt fabricate și expediate, astfel încât platforma dvs. să poată afișa vânzătorilor informații precise privind starea acestora.
- Studio — atașați un design personalizat în Fabrixa Studio (instrumentul nostru de personalizare a produselor, integrabil și cu marcă albă) la o comandă pe baza
cart_item_key, așa că ceea ce a proiectat cumpărătorul este exact ceea ce se imprimă.
Autentificare și limite de rată
Integrarea API (v2) se află la adresa URL de bază https://api.fabrixa.com/v2/integration. Fiecare solicitare conține două anteturi:
| Antet | Scop |
|---|---|
Autorizare: La purtător |
Tokenul dvs. API — identifică și autorizează solicitarea. |
X-Application-Key: |
Cheia aplicației dumneavoastră — se asociază cu tokenul, așa că ambele trebuie să fie prezente. |
Limita de frecvență este 30 de solicitări pe minut. Această capacitate este suficientă pentru traficul generat de comenzi, dar înseamnă că operațiunile în bloc ar trebui efectuate în mod eșalonat, nu într-o buclă strânsă. Gestionați limita cu tact, încetiniți ritmul când o atingeți și folosiți webhook-urile (mai jos) în locul interogărilor periodice.
Webhooks: reacționează la starea sistemului, nu o verifica periodic
În loc să întrebi mereu “S-a terminat deja?”, abonează-te la webhooks și lasă Fabrixa să te anunțe când apare o schimbare. Integrarea API generează două evenimente:
- order.created — se activează atunci când o comandă este acceptată pentru producție. Folosește-o pentru a confirma vânzătorului primirea comenzii și pentru a marca comanda ca fiind în curs de procesare.
- order.updated — se declanșează pe măsură ce comanda parcurge etapele de producție și expediere, inclusiv urmărirea. Folosește-l pentru a menține sincronizarea stării platformei dumneavoastră fără a depăși limita de rate.
Între două evenimente și o limită maximă de 30 pe minut, o integrare bine realizată abia atinge limita: trimite comanda, apoi reacționează la răspunsul primit.
Fluxul de comenzi, de la început până la sfârșit
Indiferent de varianta pe care o alegi, forma este aceeași:
- Conectați-vă — un magazin online (Shopify sau WooCommerce) sau API.
- Proiectare — personalizați-l în Fabrixa Studio sau furnizați un fișier PDF gata de tipar.
- Trimite comanda — prin intermediul API, cu rânduri de produse, client și adresă de livrare.
- Producem și livrăm — Fabrixa se ocupă de tipărire, ambalare și expediere, sub marcă proprie.
O scurtă mențiune despre calitate, deoarece acesta este motivul pentru care vânzătorii aleg vopsirea reactivă: colorantul reactiv formează o legătură covalentă cu celuloza din fibra de bumbac și se fixează permanent sub acțiunea căldurii și a aburului. Culoarea devine parte integrantă a fibrei — fără strat superficial, fără crăpături la punctele de îndoire — astfel încât materialul se simte ca bumbacul neimprimat și, de obicei, își păstrează culoarea pentru peste 600 de cicluri de spălare. Ca exemplu de termen de livrare, articolele de îmbrăcăminte fabricate în Portugalia sunt gata în aproximativ 6–9 zile lucrătoare.
De ce platformele se bazează pe Fabrixa
- MOQ 1 — de la o singură bucată la zeci de mii. Fără comandă minimă, fără taxe de configurare, fără contracte.
- White-label în mod implicit — marca clientului pe fiecare colet, nu a noastră.
- Lanț de aprovizionare scurt al UE — transportul de marfă în Portugalia, Spania și Țările de Jos, nu transportul pe distanțe lungi.
- Imprimare cu adevărat reactivă — Bumbac organic certificat GOTS ca material de bază standard pentru îmbrăcăminte, precum și certificările OEKO-TEX Standard 100 și Made in Green.
Întrebări frecvente
Trebuie să folosesc Fabrixa Studio pentru a putea utiliza API?
Nu. Opțiunea „Studio” este opțională. În schimb, puteți trimite un fișier PDF gata de tipar odată cu comanda. Opțiunea „Studio” este utilă doar atunci când dorești ca cumpărătorii să personalizeze un produs în magazinul dumneavoastră online, iar dumneavoastră atașezi acel design la comandă prin cart_item_key.
Cum pot autentifica cererile?
Trimiteți două antete la fiecare apel: Autorizare: La purtător și X-Application-Key:. Ambele sunt obligatorii — dacă lipsește una dintre ele, cererea va fi respinsă.
Ce se întâmplă dacă ating limita de acces?
Limită maximă pentru API este de 30 de solicitări pe minut. Dacă depășiți această limită, așteptați puțin și încercați din nou, în loc să suprasolicitați punctul de acces. Pentru modificările de stare, utilizați order.created și order.updated webhook-uri în loc de interogări periodice — te mențin la curent fără a consuma cereri.
Serviciul „fulfilment” este într-adevăr de tip „white-label”?
Da. Coletele sunt expediate sub marca dumneavoastră, cu adresa dumneavoastră de retur, fără niciun element de branding Fabrixa, conform procedurii standard. Clienții dumneavoastră finali nu ne vor vedea niciodată.
Începe să construiești
Cea mai rapidă cale de acces este ghid de integrare, cu sprijinul deplin al Documentația API. Dacă preferi să vezi mai întâi cum se leagă totul, atunci prezentare generală a platformei trece prin etapele de canale, studio, producție și expediere. Iar dacă doriți să testați compatibilitatea cu platforma dumneavoastră, discutați cu echipa noastră — suntem bucuroși să analizăm împreună cazul dumneavoastră de utilizare.
