Fabrixa pēc pieprasījuma drukāšanas risinājums API ļauj jebkurai POD platformai vai interneta veikalam nosūtīt pasūtījumu un izsekot tā aprites ciklam caur order.created un order.updated izmantojiet webhooks un ļaujiet Fabrixa izdrukāt, iesaiņot un nosūtīt preces ar „white-label“ apzīmējumu — sākot no viena gabala, visā ES teritorijā. Jūs veidojat pirkšanas pieredzi; mēs nodrošinām tekstilizstrādājumu ražošanu atbilstoši pasūtījumam. Nav minimālā pasūtījuma apjoma, nav iestatīšanas maksu, uz sūtījuma nav Fabrixa zīmola.
Šis raksts ir vienkāršā valodā izklāstīts pārskats par integrāciju API (v2) programmētājiem, kuri izvērtē Fabrixa kā pasūtījumu izpildes slāni. Ja vēlaties drīzāk pārskatīt atsauci, pilnā API dokumentācija un soli pa solim integrācijas rokasgrāmata esam gatavi, kad jūs būsiet gatavi.
Kādam nolūkam paredzēts API
Fabrixa ir reaktīvā tekstila apdruka platforma: viena vadības paneļa pārskats par pārdošanas kanāliem, dizainiem, ražošanu un nosūtīšanu. Lielākā daļa klientu izmanto savienojumu ar Shopify, WooCommerce vai Fabrixa Studio. Integrācija API ir ceturtais risinājums — izstrādāts POD platformām un izstrādātājiem, kuriem jau ir savs veikals un kuri vēlas programmatiski kontrolēt pasūtījumu izpildi.
Jūs sazināties ar API, lai nosūtītu pasūtījumus. Fabrixa tos izgatavo: reaktīvā apdruka uz kokvilnas un lina auduma Portugālē un Spānijā, sublimācijas apdruka uz poliestera Nīderlandē. Sūtījumi tiek nosūtīti ar jūsu zīmolu, norādot jūsu atgriešanas adresi, un uz iepakojuma nav redzami nekādi Fabrixa marķējumi. Jūsu klienti nekad neuzzinās par mūsu pastāvēšanu, ja vien jūs viņiem to nepastāstīsiet.
Kā darbojas API
- Ping — vienkārša pārbaude, lai pārliecinātos, ka jūsu autentifikācijas dati un savienojums darbojas, pirms nosūtāt kādu reālu informāciju.
- Produkti — iepazīstieties ar katalogu, uz kura pamata veidojat savu piedāvājumu: apģērbi, mājas tekstils un audums metrā, kā arī pamatmodeļi un varianti, kas pieejami apdrukai.
- Pasūtījumi — izveidot pasūtījumu un noskaidrot tā statusu. Tas ir jebkuras integrācijas pamatā: tiek ievadītas rindas, avoti, klienta un piegādes dati; rezultātā tiek saņemts pasūtījums ar izsekošanas informāciju.
- Pasūtījumu izpilde — sekot līdzi ražošanas un nosūtīšanas procesam, tiklīdz preces tiek izgatavotas un nosūtītas, lai jūsu platforma varētu pārdevējiem parādīt precīzu statusu.
- Studija — pievienojiet personalizētu dizainu Fabrixa Studio (mūsu ievietojamais, „white-label“ produktu konfigurators) pasūtījumam pēc tā
preces_nosaukums, tātad tas, ko pircējs ir izstrādājis, tiek arī precīzi izdrukāts.
Autentifikācija un pieprasījumu ierobežojumi
Integrācija API (v2) atrodas pamatadresē https://api.fabrixa.com/v2/integration. Katrs pieprasījums ietver divas virsrakstu rindas:
| Virsraksts | Mērķis |
|---|---|
Autorizācija: Uzrādītājs |
Jūsu API žetons — identificē un apstiprina pieprasījumu. |
X-Application-Key: |
Jūsu lietojumprogrammas atslēga — tā darbojas kopā ar žetonu, tāpēc abiem ir jābūt klāt. |
Pieļaujamais pieprasījumu skaits ir 30 pieprasījumi minūtē. Tas ir pietiekami, lai apkalpotu pasūtījumu radīto apmeklētāju plūsmu, taču tas nozīmē, ka masveida darbības ir jāveic pakāpeniski, nevis īsā ciklā. Rīkojieties ar ierobežojumu apdomīgi — samaziniet intensitāti, kad tas tiek sasniegts, un izmantojiet webhookus (skatīt zemāk) nevis regulāru pārbaudi.
Webhooks: reaģējiet uz stāvokli, nevis to pārbaudiet regulāri
Tā vietā, lai atkārtoti jautātu “vai tas jau ir paveikts?”, abonējiet webhookus un ļaujiet Fabrixa jums paziņot, kad notiek kādas izmaiņas. Integrācija API ģenerē divus notikumus:
- order.created — tiek aktivizēts, kad pasūtījums tiek pieņemts ražošanā. Izmanto to, lai apstiprinātu saņemšanu pārdevējam un atzīmētu pasūtījumu kā apstrādē esošu.
- order.updated — tiek izpildīti, kamēr pasūtījums virzās cauri ražošanas un nosūtīšanas posmiem, ieskaitot izsekošanu. Izmantojiet to, lai saglabātu jūsu platformas statusa sinhronizāciju, nepārsniedzot pieļaujamo pieprasījumu limitu.
Ņemot vērā divus notikumus un ierobežojumu 30 reizes minūtē, pareizi izstrādāta integrācija gandrīz nesasniedz šo limitu: vispirms nosūta rīkojumu, tad reaģē uz saņemto atbildi.
Pasūtījumu plūsma no sākuma līdz galam
Neatkarīgi no tā, kuru ceļu izvēlaties, forma ir vienāda:
- Savienot — veikals (Shopify vai WooCommerce) vai API.
- Dizains — pielāgojiet Fabrixa Studio vidē vai iesniedziet drukai gatavu PDF failu.
- Nosūtīt pasūtījumu — izmantojot API, norādot produktu rindas, klientu un piegādes adresi.
- Mēs ražojam un nosūtām — Fabrixa nodrošina drukāšanu, iepakošanu un nosūtīšanu, izmantojot „white-label“ pakalpojumus.
Īsa piezīme par kvalitāti, jo tieši tāpēc pārdevēji izvēlas reaktīvo krāsošanu: reaktīvā krāsa veido kovalento saiti ar kokvilnas šķiedras celulozi un tiek pastāvīgi fiksēta, izmantojot siltumu un tvaiku. Krāsa kļūst par šķiedras sastāvdaļu — nav virsmas slāņa, nav plaisāšanas locījumu vietās — tāpēc audums uz taustes atgādina neapdrukātu kokvilnu un parasti saglabā krāsu vairāk nekā 600 mazgāšanas ciklu laikā. Piemēram, apģērbu ražošanas laiks Portugālē ir aptuveni 6–9 darbdienas.
Kāpēc platformas tiek veidotas, pamatojoties uz Fabrixa
- MOQ 1 — no viena gabala līdz desmitiem tūkstošu. Nav minimālā pasūtījuma, nav sagatavošanas maksu, nav līgumu.
- Pēc noklusējuma — „White-label“ — uz katras sūtījuma ir norādīts klienta zīmols, nevis mūsu.
- Īsa ES piegādes ķēde — ražošana visā Portugālē, Spānijā un Nīderlandē, nevis tālsatiksmes kravu pārvadājumi.
- Īsta reaktīvā apdruka — GOTS sertificēta bioloģiskā kokvilna kā apģērbu standarta pamatmateriāls, kā arī OEKO-TEX Standard 100 un Made in Green sertifikāti.
Bieži uzdotie jautājumi
Vai man ir jāizmanto Fabrixa Studio, lai varētu lietot API?
Nē. „Studio” ir fakultatīva funkcija. Tā vietā kopā ar pasūtījumu varat nosūtīt drukai gatavu PDF failu. „Studio” tiek izmantota tikai tad, ja vēlaties, lai pircēji jūsu veikalā personalizētu produktu, un jūs pievienojat šo dizainu pasūtījumam, preces_nosaukums.
Kā varu autentificēt pieprasījumus?
Katram izsaukumam nosūtiet divus galvenes: Autorizācija: Uzrādītājs un X-Application-Key:. Abi ir nepieciešami kopā — ja trūks viens no tiem, pieteikums tiks noraidīts.
Kas notiks, ja es sasniegšu pieļaujamo pieprasījumu skaitu?
API ierobežo pieprasījumu skaitu līdz 30 pieprasījumiem minūtē. Ja šo limitu pārsniedzat, pārtrauciet mēģinājumus un mēģiniet vēlreiz, nevis nepārtraukti noslogojiet galapunktu. Statusa izmaiņām izmantojiet order.created un order.updated webhooki, nevis periodiskā pārbaude — tie nodrošina sinhronizāciju, neizmantojot pieprasījumus.
Vai šis risinājums patiešām ir „white-label“?
Jā. Sūtījumi tiek nosūtīti ar jūsu zīmolu un jūsu atgriešanas adresi, un standarta gadījumā uz tiem nav redzams Fabrixa zīmols. Jūsu gala klienti mūs nekad neredz.
Sāciet būvēt
Ātrākais veids, kā tur nokļūt, ir integrācijas rokasgrāmata, ko pilnībā atbalsta API dokumentācija. Ja vēlaties vispirms apskatīt, kā viss kopā saskan, tad platformas pārskats iet cauri kanāliem — studijai, ražošanai un nosūtīšanai. Un, ja vēlaties pārbaudīt, vai tas ir piemērots jūsu platformai, sazinieties ar mūsu komandu — mēs ar prieku izskatīsim jūsu lietošanas gadījumu.
