„Fabrixa“ spausdinimo pagal užsakymą paslauga „API“ leidžia bet kuriai „POD“ platformai ar internetinei parduotuvei išsiųsti užsakymą ir stebėti jo gyvavimo ciklą per order.created ir order.updated webhooks, o „Fabrixa“ pasirūpins spausdinimu, pakavimu ir siuntimu su „white-label“ ženklu – nuo vieno vieneto iki visos ES. Jūs kuriate pirkimo patirtį, o mes už jos ribų vykdome tekstilės gamybą pagal užsakymus. Nėra minimalaus užsakymo kiekio, nėra parengimo mokesčių, ant siuntinio nėra „Fabrixa“ prekės ženklo.
Šis įrašas – paprasta kalba parašyta „Integration API (v2)“ apžvalga, skirta programuotojams, kurie svarsto galimybę naudoti „Fabrixa“ kaip užsakymų vykdymo sluoksnį. Jei norite greitai peržiūrėti informaciją, pilną API dokumentacija ir žingsnis po žingsnio integracijos vadovas Esame pasiruošę, kai tik Jūs būsite pasiruošę.
Kam skirtas API
Fabrixa yra reaktyvi tekstilės spausdinimo platforma: viena valdymo panelė, skirta pardavimo kanalams, dizainui, gamybai ir išsiuntimui. Dauguma klientų prisijungia per „Shopify“, „WooCommerce“ arba „Fabrixa Studio“. „API“ integracija yra ketvirtasis būdas — sukurta „POD“ platformoms ir kūrėjams, kurie jau turi savo parduotuvę ir nori programiškai valdyti užsakymų vykdymą.
Jūs skambinate į „API“, kad pateiktumėte užsakymus. „Fabrixa“ juos pagamina: reaktyviniu spausdinimu ant medvilnės ir lino Portugalijoje bei Ispanijoje, sublimacijos būdu ant poliesterio Nyderlanduose. Siuntos išsiunčiamos su Jūsų prekės ženklu, nurodant Jūsų grąžinimo adresą, o ant pakuotės niekur nėra jokių „Fabrixa“ žymių. Jūsų klientai niekada nesužinos apie mūsų egzistavimą, nebent Jūs jiems apie tai pasakytumėte.
Ką daro API
- Ping — paprastas veikimo patikrinimas, skirtas įsitikinti, kad Jūsų prisijungimo duomenys ir ryšys veikia, prieš siunčiant kokią nors tikrą informaciją.
- Produktai — susipažinkite su katalogu, kurį rengiate: drabužiai, namų tekstilė ir audiniai metrais, su pagrindiniais modeliais ir variantais, pritaikytais spausdinimui.
- Užsakymai — sukurti užsakymą ir patikrinti jo būseną. Tai yra bet kokios integracijos esmė: įvedami įrašai, šaltiniai, kliento ir pristatymo duomenys; gaunamas užsakymas su sekimo informacija.
- Užsakymų vykdymas — stebėkite gamybą ir išsiuntimą, kai prekės yra pagaminamos ir išsiunčiamos, kad Jūsų platforma galėtų pardavėjams pateikti tikslią informaciją apie prekių būseną.
- Studija — pridėkite individualiai pritaikytą dizainą Fabrixa Studio (mūsų įterpiamą „white-label“ produkto konfigūratorių) prie užsakymo pagal jo
prekės_raktas, taigi tai, ką pirkėjas suprojektavo, yra būtent tai, kas ir bus atspausdinta.
Autentifikavimas ir srauto apribojimai
„Integration API (v2)“ yra pasiekiamas per bazinį URL adresą https://api.fabrixa.com/v2/integration. Kiekvienas užklausimas apima du antraštės:
| Antraštė | Tikslas |
|---|---|
Autorizacija: Pateikėjas |
Jūsų API žetonas — identifikuoja ir patvirtina užklausą. |
X-Application-Key: |
Jūsų programos raktas — jis susietas su žetonu, todėl turi būti pateikti abu. |
Ribinis dažnis yra 30 užklausų per minutę. To pakanka užsakymų generuojamam srautui, tačiau tai reiškia, kad masinės operacijos turėtų būti atliekamos palaipsniui, o ne vykdomos trumpais ciklais. Elkitės su šiuo apribojimu taktiškai – pasiekus jį, sulėtinkite tempą ir vietoj nuolatinio užklausimų siuntimo naudokitės „webhooks“ (žr. toliau).
Webhooks: reaguokite į būseną, o ne tikrinkite jos
Užuot nuolat klausus “ar jau baigta?”, užsiprenumeruokite „webhooks“ ir leiskite „Fabrixa“ pranešti Jums, kai kas nors pasikeis. Integracija „API“ generuoja du įvykius:
- order.created — suaktyvinamas, kai užsakymas priimamas į gamybą. Naudokite jį, kad pardavėjui patvirtintumėte užsakymo gavimą ir pažymėtumėte užsakymą kaip vykdomą.
- order.updated — siunčia užklausas, kai užsakymas juda per gamybos ir išsiuntimo etapus, įskaitant sekimą. Naudokite šią funkciją, kad sinchronizuotumėte savo platformos būseną, neviršydami leidžiamo užklausų skaičiaus.
Atsižvelgiant į du įvykius ir 30 per minutę ribą, tinkamai veikianti integracija vos nepasiekia ribos: išsiųskite užsakymą, tada reaguokite į gautą atsakymą.
Užsakymų srautas nuo pradžios iki pabaigos
Kad ir kokį variantą pasirinksite, forma lieka ta pati:
- Prisijungti — internetinė parduotuvė („Shopify“ arba „WooCommerce“) arba „API“.
- Dizainas — pritaikykite „Fabrixa Studio“ arba pateikite spausdinimui parengtą PDF failą.
- Išsiųsti užsakymą — per API, su prekių eilutėmis, kliento ir pristatymo adresu.
- Mes gaminame ir išsiunčiame — „Fabrixa“ spausdina, pakuoja ir siunčia prekes „white-label“ principu.
Trumpas pastebėjimas apie kokybę, nes būtent dėl to pardavėjai renkasi reaktyvius dažus: reaktyvieji dažai sudaro kovalentinį ryšį su medvilnės pluošto celiulioze ir yra ilgam įtvirtinami veikiant karščiui bei garams. Spalva tampa pluošto dalimi – nėra paviršinio sluoksnio, nesusidaro įtrūkimų lenkimo vietose – todėl audinys lieka toks pat kaip nespausdinta medvilnė, o spalva paprastai išlieka po daugiau nei 600 skalbimo ciklų. Pavyzdžiui, drabužių, pagamintų Portugalijoje, pagaminimo laikas yra maždaug 6–9 darbo dienos.
Kodėl platformos kuriamos remiantis „Fabrixa“ principu
- MOQ 1 — nuo vieno vieneto iki dešimčių tūkstančių. Nėra minimalaus užsakymo kiekio, nėra parengimo mokesčių, nėra sutarčių.
- Pagal numatytuosius nustatymus – „White-label“ — ant kiekvienos siuntinės turi būti nurodytas kliento prekės ženklas, o ne mūsų.
- Trumpas ES tiekimo grandinės maršrutas — gamyba Portugalijoje, Ispanijoje ir Nyderlanduose, o ne tolimojo nuotolio krovinių gabenimas.
- Tikrasis reaktyvusis spausdinimas — GOTS sertifikuota ekologiška medvilnė kaip standartinė drabužių pagrindinė medžiaga, taip pat atitinkanti „OEKO-TEX Standard 100“ ir „Made in Green“ standartus.
DUK
Ar norint naudoti „API“ reikia naudoti „Fabrixa Studio“?
Ne. „Studio“ funkcija nėra privaloma. Vietoj to kartu su užsakymu galite atsiųsti spausdinimui paruoštą PDF failą. „Studio“ funkcija naudojama tik tuomet, kai norite, kad pirkėjai Jūsų parduotuvėje individualizuotų produktą, o tą dizainą prie užsakymo pridedate prekės_raktas.
Kaip patvirtinti užklausų autentiškumą?
Kiekvieno skambučio metu siųskite du antraštes: Autorizacija: Pateikėjas ir X-Application-Key:. Abu šie reikalavimai turi būti įvykdyti kartu — jei trūks vieno iš jų, paraiška bus atmesta.
Kas atsitiks, jei pasieksiu užklausų skaičiaus ribą?
API riboja užklausų skaičių iki 30 per minutę. Jei šią ribą viršijate, palaukite ir pabandykite dar kartą, o ne nuolat siųskite užklausas į galinį tašką. Būsenos pokyčiams naudokite order.created ir order.updated „webhooks“ vietoj periodinio užklausų siuntimo — jie užtikrina sinchronizaciją nenaudojant užklausų.
Ar užsakymų vykdymas iš tiesų yra „white-label“?
Taip. Siuntos išsiunčiamos su Jūsų prekės ženklu ir Jūsų grąžinimo adresu, o „Fabrixa“ prekės ženklas paprastai nenurodomas. Jūsų galutiniai klientai mūsų niekada nemato.
Pradėkite kurti
Greičiausias būdas patekti į vidų yra integracijos vadovas, kurį visapusiškai remia API dokumentacija. Jei norėtumėte pirmiausia pamatyti, kaip visa tai dera tarpusavyje, tai platformos apžvalga apima visus etapus: kanalus, studiją, gamybą ir išsiuntimą. O jei norėtumėte išbandyti, ar tai tinka Jūsų platformai, susisiekite su mūsų komanda — mielai aptarsime Jūsų naudojimo atvejį.
