Fabrixa print on demand -API mahdollistaa sen, että mikä tahansa POD-alusta tai verkkokauppa voi lähettää tilauksen ja seurata sen elinkaarta webhookien order.created ja order.updated kautta, ja Fabrixa huolehtii tuotteen painatuksesta, pakkaamisesta ja lähettämisestä white-label-periaatteella – jo yhdestä kappaleesta lähtien, kaikkialla EU:ssa. Sinä luot ostokokemuksen; me hoidamme sen taustalla toimivan reaktiivipainatukseen perustuvan tekstiilituotannon. Ei minimitilausmäärää, ei aloitusmaksuja, eikä Fabrixa-brändäystä paketissa.
Tämä kirjoitus on selkokielinen yleiskatsaus Integration API (v2) -ratkaisusta kehittäjille, jotka arvioivat Fabrixa-yhtiötä fulfilment-kerroksena. Jos haluat sen sijaan selata viiteasiakirjaa, koko API-dokumentaatio ja vaihe vaiheelta integraatio-opas ovat valmiina, kun sinä olet.
Mihin API:tä käytetään
Fabrixa on reaktiivinen tekstiilipainatusalusta: yksi hallintapaneeli myyntikanaville, suunnittelulle, tuotannolle ja lähetyksille. Suurin osa asiakkaista käyttää Shopify-, WooCommerce- tai Fabrixa Studio -integraatiota. API-integraatio on neljäs vaihtoehto — se on kehitetty POD-alustoille ja kehittäjille, joilla on jo oma verkkokauppa ja jotka haluavat ohjelmoitavan hallinnan tilausten käsittelyyn.
Kutsut API:a tilausten lähettämistä varten. Fabrixa huolehtii niiden valmistuksesta: reaktiivinen painatus puuvillalle ja pellavalle Portugalissa ja Espanjassa, sublimaatiopainatus polyesterille Alankomaissa. Paketit lähetetään sinun tuotemerkilläsi, sinun palautusosoitteellasi, eikä pakkauksessa ole missään Fabrixa-yhtiön merkintöjä. Asiakkaasi eivät koskaan saa tietää meidän olemassaolostamme, ellet itse kerro heille.
Mitä API tekee
- Ping — kevyt toimintatarkistus, jolla varmistetaan, että tunnistetietosi ja yhteytesi toimivat, ennen kuin lähetät mitään varsinaista tietoa.
- Tuotteet — tutustu tuoteluetteloon, jonka pohjalle rakennat: vaatteet, kodintekstiilit ja metritavara, sekä painatukseen soveltuvat pohjamallit ja niiden muunnelmat.
- Tilaukset — luo tilaus ja tarkista sen tila. Tämä on kaiken integraation ydin: syötetään rivejä, lähteitä, asiakas- ja toimitustietoja, ja tuloksena saadaan seurattava tilaus.
- Fulfilment — seuraa tuotantoa ja lähetystä tuotteiden valmistuksen ja lähettämisen yhteydessä, jotta alustasi voi näyttää myyjille tarkat tilatiedot.
- Studio — liitä mukaan yksilöllisesti muotoiltu malli Fabrixa Studio -työkalussa (upotettava, white-label-tuotemuokkaajamme) tilaukseen sen
cart_item_key-tunnisteen avulla, joten ostajan suunnittelema malli painetaan täsmälleen sellaisenaan.
Todentaminen ja käyttörajoitukset
Integration API (v2) sijaitsee perus-URL-osoitteessa https://api.fabrixa.com/v2/integration. Jokainen pyyntö sisältää kaksi otsikkoa:
| Yläreuna | Tarkoitus |
|---|---|
Valtuutus: Kantaja |
API-tunnus — tunnistaa pyynnön ja valtuuttaa sen. |
X-Application-Key: |
Sovelluksen avain — se muodostaa parin tunnuksen kanssa, joten molempien on oltava olemassa. |
Rate limit on 30 pyyntöä minuutissa. Se riittää tilauspohjaiselle liikenteelle, mutta se tarkoittaa, että massatoimintoja tulisi ajoittaa tasaisesti sen sijaan, että niitä suoritettaisiin tiheässä syklissä. Käsittele rajoitusta joustavasti, hidasta vauhtia, kun se saavutetaan, ja hyödynnä webhookeja (katso alla) kyselyjen sijaan.
Webhookit: reagoi tilaan, älä tarkista sitä jatkuvasti
Sen sijaan, että kysyisit toistuvasti “onko se jo valmis?”, tilaa webhookit ja anna Fabrixa-yhtiön ilmoittaa sinulle, kun jotain muuttuu. API-integraatio lähettää kaksi tapahtumaa:
- order.created — laukeaa, kun tilaus hyväksytään tuotantoon. Käytä sitä vahvistaaksesi vastaanoton myyjälle ja merkitäksesi tilauksen käsiteltäväksi.
- order.updated — laukeaa, kun tilaus etenee tuotanto- ja toimitusprosessin läpi, seuranta mukaan lukien. Käytä sitä pitääksesi alustasi tilan ajan tasalla ilman, että rate limit ylittyy.
Kun tapahtumia on kaksi ja minuuttikohtainen yläraja on 30, hyvin toimiva integraatio hipoo tuskin rajaa: lähetä tilaus ja reagoi sitten saatuun vastaukseen.
Tilausvirta alusta loppuun
Kumpi reitti valitsetkin, muoto on sama:
- Yhdistä — verkkokauppa (Shopify tai WooCommerce) tai API.
- Suunnittelu — muokkaa Fabrixa Studiossa tai toimita tulostusvalmis PDF-tiedosto.
- Lähetä tilaus — API:n kautta, sisältäen tuotetiedot, asiakastiedot sekä toimitusosoitteen.
- Valmistamme ja toimitamme — Fabrixa huolehtii painatuksesta, pakkaamisesta ja lähettämisestä white label -periaatteella.
Lyhyt huomautus laadusta, sillä juuri sen vuoksi myyjät valitsevat reaktiivisen värjäyksen: reaktiivinen väriaine muodostaa kovalenttisen sidoksen puuvillakuidun selluloosan kanssa ja kiinnittyy pysyvästi lämmön ja höyryn vaikutuksesta. Väri sulautuu osaksi kuitua – ei pintakerrosta, ei halkeilua taivutuskohdissa – joten se tuntuu kuin painamattomalta puuvillalta ja säilyttää värinsä tyypillisesti yli 600 pesukerran ajan. Tuotantoajan esimerkkinä mainittakoon, että Portugalissa valmistettujen vaatteiden tuotantoaika on noin 6–9 arkipäivää.
Miksi alustat perustuvat Fabrixa-periaatteeseen
- MOQ 1 — yhdestä kappaleesta kymmeniin tuhansiin. Ei vähimmäistilausmäärää, ei aloitusmaksuja, ei sopimuksia.
- Oletusarvoisesti white-label-versio — jokaisessa paketissa on asiakkaan brändi, ei meidän.
- EU:n lyhyt toimitusketju — tuotantoa Portugalissa, Espanjassa ja Alankomaissa, ei kaukoliikenteen rahtikuljetuksia.
- Todellinen reaktiivinen painatus — GOTS-sertifioitu luomupuuvilla on oletusmateriaali, ja tuotteet täyttävät lisäksi OEKO-TEX Standard 100 - ja Made in Green -vaatimukset.
Usein kysytyt kysymykset
Pitääkö minun käyttää Fabrixa Studio -työkalua, jotta voin käyttää API:tä?
Ei. Studio on valinnainen. Voit sen sijaan lähettää tilauksen mukana tulostusvalmiin PDF-tiedoston. Studio tulee kyseeseen vain silloin, kun haluat ostajien voivan räätälöidä tuotteen verkkokaupassasi, ja liität kyseisen mallin tilaukseen cart_item_key.
Miten todennan pyynnöt?
Lähetä jokaisessa kutsussa kaksi otsikkoa: Valtuutus: Kantaja ja X-Application-Key:. Molemmat ovat pakollisia – jos toinen puuttuu, hakemus hylätään.
Mitä tapahtuu, jos saavutan rate limitin?
API-rajapinnan enimmäismäärä on 30 pyyntöä minuutissa. Jos ylität tämän rajan, odota hetki ja yritä uudelleen sen sijaan, että pommittaisit päätepistettä jatkuvasti. Tilanmuutosten osalta käytä order.created ja order.updated webhookit kyselyjen sijaan — ne pitävät tiedot ajan tasalla ilman, että pyyntöjä kuluu.
Onko fulfilment todella white-label-palvelu?
Kyllä. Lähetykset toimitetaan vakiona teidän tuotemerkillänne ja palautusosoitteellanne, eikä niissä ole Fabrixa-brändäystä. Loppuasiakkaanne eivät koskaan näe meitä.
Aloita rakentaminen
Nopein reitti sisään on integraatio-opas, jota tukee kattava API-dokumentaatio. Jos haluat mieluummin ensin nähdä, miten koko asia liittyy toisiinsa, niin alustan yleiskatsaus kulkee kanavien, Studio-työkalun, tuotannon ja lähetyksen kautta. Ja jos haluat testata, sopiiko se alustallesi, juttele tiimimme kanssa — käymme mielellämme läpi käyttötapauksesi.
