Fabrixa tellimuspõhine trükiteenus API võimaldab igal POD platvormil või veebipoes saata tellimuse ja jälgida selle elutsüklit kogu order.created ja order.updated webhookid ning laske Fabrixa-l seda valge sildiga trükkida, pakkida ja saata – alates ühest tükist kogu ELi piires. Teie loote ostukogemuse; meie hoolitseme selle taga reageeriva tekstiilitootmise eest. Minimaalset tellimust ei ole, seadistustasusid ei ole, pakendil ei ole Fabrixa-i brändimärgistust.
See postitus on lihtsas keeles kirjutatud ülevaade integratsioonist API (v2) arendajatele, kes kaaluvad Fabrixa kasutamist täitmiskihina. Kui soovite pigem viidet kiiresti läbi vaadata, siis täielik API dokumentatsioon ja samm-sammult integreerimisjuhend oleme valmis, kui Teie olete valmis.
Milleks API on mõeldud
Fabrixa on reaktiivne tekstiiliprindi platvorm: üks juhtpaneel müügikanalite, disainide, tootmise ja saatmise jaoks. Enamik kliente ühendub Shopify, WooCommerce või Fabrixa Studio kaudu. Integreerimine API on neljas võimalus – loodud POD platvormide ja arendajate jaoks, kellel on juba olemas oma veebipood ja kes soovivad tellimuste täitmist programmiliselt juhtida.
Te helistate API-le, et tellimusi edastada. Fabrixa valmistab need: reaktiivtrükk puuvillale ja linale Portugalis ja Hispaanias, sublimatsiooniprint polüesterile Hollandis. Pakid saadetakse teie kaubamärgi all, teie tagastusaadressiga ning pakendil ei ole kuskil Fabrixa-i märgistusi. Teie kliendid ei saa kunagi teada meie olemasolust, kui te neile sellest ise ei räägi.
Mida API teeb
- Ping — lihtne kontroll, millega veenduda, et su kasutajatunnused ja ühendus toimivad, enne kui saadad midagi tõelist.
- Tooted — tutvuge kataloogiga, mille alusel te oma tooteid koostate: rõivad, kodutekstiil ja meetrikaupa müüdav kangas, millel on trükkimiseks sobivad alused ja variandid.
- Tellimused — tellimuse loomine ja selle staatuse vaatamine. See on iga integratsiooni tuum: sisestatakse ridad, allikad, kliendi- ja saatmisandmed; tulemuseks on jälgitav tellimus.
- Täitmised — jälgige tootmist ja väljasaatmist, kui tooted valmivad ja saadetakse välja, et teie platvorm saaks müüjatele näidata täpset staatust.
- Stuudio — lisage isikupärastatud kujundus Fabrixa Studio (meie sisseehitatav, valge sildiga tootekonfigurator) tellimusele selle
ostukorvi_toote_võti, seega trükitakse täpselt see, mida ostja on kujundanud.
Autentimine ja kasutamispiirangud
Integratsioon API (v2) asub baas-URL-is https://api.fabrixa.com/v2/integration. Iga päring sisaldab kaks pealkirja:
| Pealkiri | Eesmärk |
|---|---|
Autoriseerimine: kandja |
Teie API-token – tuvastab ja kinnitab päringu. |
X-Application-Key: |
Teie rakenduse võti — moodustab paari märgiga, seega peavad mõlemad olemas olema. |
Kiiruspiirang on 30 päringut minutis. See on tellimuspõhise liikluse jaoks piisav, kuid see tähendab, et massoperatsioone tuleks teostada järk-järgult, mitte tihedas tsüklis. Käsitle piirangut sujuvalt, vähenda koormust, kui see saavutatakse, ja kasuta veebihookide (allpool) asemel päringuid.
Webhookid: reageeri seisundile, ära küsi seda pidevalt järele
Selle asemel, et korduvalt küsida “kas see on juba valmis?”, telli webhookid ja lase Fabrixa-l Teile teatada, kui midagi muutub. Integreerimine API edastab kaks sündmust:
- order.created — käivitub, kui tellimus võetakse tootmisse. Kasuta seda, et kinnitada müüjale tellimuse kättesaamist ja märkida tellimus töös olevaks.
- order.updated — käivitub, kui tellimus liigub tootmise ja saatmise etapid läbi, sealhulgas jälgimine. Kasutage seda, et hoida oma platvormi staatust sünkroonis, ilma et ületaksite oma piirangut.
Kahe sündmuse ja 30-minutilise ülempiiri vahel jõuab korralikult toimiv integratsioon vaevalt piirini: saada käsk ja reageeri seejärel saadud vastusele.
Tellimuste voog algusest lõpuni
Ükskõik millise variandi Teie valida, on vorm sama:
- Ühenda — veebipood (Shopify või WooCommerce) või API.
- Disain — kohandage seda Fabrixa Studio keskkonnas või saatke trükivalmis PDF-fail.
- Saada tellimus — API kaudu, koos tooteridadega, kliendi- ja tarneaadressiga.
- Me toodame ja saadame — Fabrixa trükib, pakendab ja saadab tooteid valge sildiga.
Lühike märkus kvaliteedi kohta, sest just sellepärast valivad müüjad reaktiivvärvi: reaktiivvärv moodustab puuvillakiu tselluloosiga kovalentse sideme ning kinnitub püsivalt kuumuse ja auru mõjul. Värv muutub kiu osaks – puudub pinnakiht, painutuskohtades ei teki pragusid –, mistõttu tundub see nagu trükkimata puuvill ja säilitab värvi tavaliselt üle 600 pesutsükli. Tootmisaja näitena võib tuua Portugalis valmistatud rõivad, mille valmimisaeg on umbes 6–9 tööpäeva.
Miks platvormid tuginevad Fabrixa-le
- MOQ 1 — ühest tükist kuni kümnetuhandeni. Minimaalset tellimust ei ole, seadistustasusid ei ole, lepinguid ei ole.
- Vaikimisi valge silt — igal pakil on kliendi kaubamärk, mitte meie oma.
- Lühike ELi tarneahel — tootmine Portugalis, Hispaanias ja Madalmaades, mitte pikamaaveod.
- Tõeline reaktiivne trükk — GOTS-sertifitseeritud orgaaniline puuvill on rõivaste standardne alusmaterjal, millele lisanduvad OEKO-TEX Standard 100 ja Made in Green.
KKK
Kas ma pean kasutama Fabrixa Studio't, et kasutada API-d?
Ei. Studio on vabatahtlik. Selle asemel võite tellimusega kaasa saata trükivalmis PDF-faili. Studio tuleb kasutusele vaid siis, kui soovite, et ostjad saaksid Teie veebipoes toodet isikupärastada, ning Teie lisad selle kujunduse tellimusele, ostukorvi_toote_võti.
Kuidas ma päringuid autentifitseerin?
Saada iga kõne puhul kaks päist: Autoriseerimine: kandja ja X-Application-Key:. Mõlemad on koos vajalikud – kui üks neist puudub, lükatakse taotlus tagasi.
Mis juhtub, kui ma jõuan kiiruspiiranguni?
API piirab päringute arvu 30-ni minutis. Kui see piir ületatakse, siis ärge suruge lõpppunkti liiga palju, vaid oodake veidi ja proovige uuesti. Staatuse muutuste puhul kasutage order.created ja order.updated webhookid päringute asemel — need hoiavad andmed sünkroonis, ilma et peaksid päringuid kulutama.
Kas täitmine on tõepoolest valge sildi lahendus?
Jah. Pakid saadetakse teie kaubamärgi all, millel on teie tagastusaadress, ning standardkorras ei ole neil Fabrixa-i kaubamärki. Teie lõppkliendid ei näe meid kunagi.
Alusta ehitamist
Kiireim viis sissepääsuks on integreerimisjuhend, mida toetab täielikult API dokumentatsioon. Kui soovite esmalt näha, kuidas see kõik kokku sobib, siis platvormi ülevaade läbib müügikanalid, stuudio, tootmise ja väljastamise. Ja kui soovite oma platvormi sobivust põhjalikult testida, võtke ühendust meie meeskonnaga — meil on hea meel teie kasutusjuhtumit läbi vaadata.
