Kétféle módon küldhet megrendeléseket az Fabrixa-nek: csatlakoztassa a már működtetett webáruházát – Shopify vagy WooCommerce – programozás nélkül, vagy közvetlenül az API integráción keresztül. Ez az útmutató mindkét lehetőséget bemutatja: csatlakoztasson egy értékesítési csatornát pár perc alatt, vagy végezze el a hitelesítéstől a teljesítésig tartó folyamatot tizenöt perc alatt.
A legtöbb webáruház soha nem használja a API-t. Ha hozzáadod az Fabrixa-t értékesítési csatornaként, az üzletedből érkező megrendelések közvetlenül a gyártásba kerülnek — a termékek szinkronizálódnak, az állapotok visszajelzésre kerülnek, és nem kell kódot írni vagy karbantartani. Az alább bemutatott API útvonal az egyedi webáruházak és az POD platformok számára készült.
A vezérlőpulton nyissa meg a Create channel és válassza ki az integráció típusát. Minden csatorna saját termékeit, importált megrendeléseit és importálási szabályait tárolja – csatlakoztathat annyit, amennyit csak üzemeltet.
Nincs kulcs, amit lemásolni kellene. Engedélyezd az Fabrixa-t a Shopify admin felületén, és a kapcsolat máris működik.
Create channel, válassza ki Shopify.A WordPress-alapú webáruház egy olvasási/írási REST-kulcspárral csatlakozik – amelyet a WooCommerce generál, és egyszer be kell illeszteni az Fabrixa-be.
Settings → Advanced → REST API → Add key a…-val Olvasás/Írás jogosultságok.ck_ kulcs, cs_ titkos kódot és az üzleted domainjét a Fabrixa-be.Egyedi termékeket árul? Fabrixa Studio — a white-label tervezőszerkesztő — a Shopify- és a WooCommerce-áruházakban is elérhető, így a vásárlóid a te márkád alatt személyre szabhatják a termékeket. Lásd: Fabrixa Studio →
A „Csatornák” nézetben a csatlakoztatott áruházak az API és a partnercsatornák mellett jelennek meg – szinkronizált termékek, beérkezett megrendelések, az utoljára importált hivatkozás és a csatornánkénti bevétel. Amikor készen állsz, állítsd át a csatornát „tervezet” állapotból „élő” állapotba; a rendszer további részei nem változnak.
Inkább egy egyedi webáruházat szeretnél létrehozni, vagy inkább a saját POD-platformodat? Az útmutató további része a API-módszert mutatja be – a felhasználói hitelesítéstől a rendelés teljesítéséig négy lépésben.
Három lépés vezet el a nullától az élő megrendelésig. Mindhárom lépést a Fabrixa irányítópultján keresztül vagy a megoldásmérnök segítségével hajthatja végre.
Egy alkalmazás-hozzáférési token és egy alkalmazáskulcs. Mindkettőre szükség van minden kérésnél — a token az Authorization fejlécben, a kulcs pedig az X-Application-Key fejlécben. Hozzon létre egy értékesítési csatornát a vezérlőpulton, hogy azonnal létrehozhassa őket — ehhez nincs szükség külön kérésre.
Egy nyilvánosan elérhető HTTPS-végpont, amely JSON POST-kérelmeket fogad. Fejlesztés közben a localhost egy alagúton keresztül működik. A feldolgozás előtt minden adatcsomag HMAC-SHA256-aláírását ellenőrizni kell.
A grafikai fájl – PDF, TIFF, JPG vagy PNG formátumban – hitelesítés nélkül elérhető HTTPS-en keresztül. RGB színskála, legfeljebb 50 MB méret és oldalanként 15 000 képpont. A többoldalas PDF-fájloknál minden réteg egy oldalt jelent. A feladat renderelésekor letöltjük a fájlt, és elkészítjük a megfelelő nyomtatási fájlokat.
Minden kérés az alap-URL-re érkezik https://api.fabrixa.com/v2/integration mindkét fejléc beállítva. GET /ping mielőtt bármit is tennél, ellenőrzi, hogy a token és a kulcs érvényesek-e.
Állapot 401 azt jelenti, hogy hiányzik a fejléc, vagy a token érvényét vesztette. Állapot 403 azt jelenti, hogy a hitelesítő adatok érvényesek, de nincs hozzáférési jogosultságuk az erőforráshoz.
# Verify auth before anything else curl https://api.fabrixa.com/v2/integration/ping \ -H "Accept: application/json" \ -H "Authorization: Bearer APPLICATION_ACCESS_TOKEN" \ -H "X-Application-Key: APPLICATION_KEY" # 200 OK → credentials valid # 401 → missing header or revoked token # 403 → valid, but no access to the resource
A katalógus a termékváltozatokat a SKU kódjukkal és variant_id. Minden listaválasz a szokásos links / meta / data boríték, ezért a next_page link. Helyi gyorsítótár — a katalógus nem kérésenkénti.
A mező teljes leírása a Swagger-referencia.
GET /v2/integration/products?page=1
{
"links": {
"self": ".../products?page=1",
"next_page": ".../products?page=2",
"prev_page": null
},
"meta": { "total": 248, "current_page": 1, "per_page": 10 },
"data": [
{ "id": 1306, "name": "Unisex AOP T-shirt", "SKU": "COF099191" }
]
}
Küldés rows (SKU + mennyiség + forrás PDF), customer és shipping_address. Állítsd be a sajátodat number referenciaként — ha kihagyod, akkor mi generálunk egyet. A visszaküldött Fabrixa megrendelési azonosítót tárold a megrendelésedhez társítva.
A stúdió megrendelései felváltják a sources fájl a cart_item_key a mentett tervből; minden egyéb megegyezik.
POST /v2/integration/orders
{
"number": "ORD-2026-0142",
"purchased_at": "2026-05-28 14:22:01",
"rows": [
{
"sku": "COF099191",
"quantity": 1,
"sources": [
{ "type": "file", "url": "https://cdn.you.com/art/9812.pdf" }
]
}
],
"customer": {
"first_name": "Maria", "last_name": "Silva",
"email": "maria@example.com", "phone": "+351912345678"
},
"shipping_address": {
"address": "Rua do Carmo 42", "city": "Lisboa",
"postal_code": "1200-094",
"country_code": "PT", "country": "Portugal"
}
}
Állítsd be a webhook URL-jét a vezérlőpulton. POST-kérést küldünk order.created és order.updated hozzá a teljes megrendelés tartalmával, egy x-webhook-signature (HMAC-SHA256) és egy x-webhook-topic fejléc. Ellenőrizze az aláírást, majd térjen vissza 200 gyors, aszinkron feldolgozás.
Minden esemény és az ellenőrző kódrészletek megtalálhatók a Webhookok – útmutató.
# Request headers content-type: application/json x-webhook-topic: order.updated x-webhook-signature: YmEwNjBhMGMy...AxMw== # Body (truncated) { "id": 23069, "number": "1250211835", "status": "imported", "fulfillment_status": "unfulfilled", "updated_at": "2026-05-28T07:43:52Z" }
A hibák JSON formátumban jelennek meg, soha nem HTML-ben. A errors.messages A `array` megnevezi, mi nem sikerült; 400-as hiba esetén felsorolja azokat a mezőket, amelyek nem feleltek meg az érvényesítési szabályoknak.
Ellenőrzési hiba, hiányzó vagy visszavont hitelesítő adatok, elégtelen jogosultság vagy ismeretlen erőforrás.
Alkalmazásonként 30 kérés percenként. X-RateLimit-Limit és X-RateLimit-Remaining minden válaszban szerepelnek.
Szerveroldalon. Próbálja meg újra várakozási idővel; ha a probléma továbbra is fennáll, küldje el a kérelem azonosítóját a megoldásmérnökének.
{
"links": { "self": ".../v2/integration/orders" },
"meta": [],
"errors": {
"messages": [
"Application Key is not specified."
]
}
}
Az Fabrixa alkalmazásonként percenként 30 kérést engedélyez; ennek túllépése esetén 429 „Too Many Requests” (Túl sok kérés) válasz kerül visszaadásra. Minden válaszban szerepelnek az X-RateLimit-Limit és az X-RateLimit-Remaining fejlécek, így az integráció nyomon követheti a fennmaradó kvótát, mielőtt elérné a korlátot.
Az Fabrixa elfogadja a PDF, TIFF, JPG vagy PNG formátumú grafikai fájlokat RGB színmódban, legfeljebb 50 MB méretben és oldalanként 15 000 képpont felbontással; ezek HTTPS-en keresztül, hitelesítés nélkül érhetők el. A többoldalas PDF-fájlokat rétegenként egy oldalként kezeli a rendszer, és a Fabrixa a feladat renderelésekor maga tölti le a fájlt a megfelelő nyomtatási fájlok elkészítéséhez.
A WooCommerce-ben lépj a Beállítások, majd a Speciális, végül a REST API menüpontra, és adj hozzá egy kulcsot olvasási/írási jogosultságokkal. Illeszd be a kapott ck_ kulcsot, a cs_ titkos kulcsot és az áruházad domainjét az Fabrixa-be, mentsd el, és a megrendelések automatikusan szinkronizálódnak — az importálási szabályok később módosíthatók a csatorna beállításaiban.
Az első megrendelés leadása előtt szükséged van egy értékesítési csatornától származó alkalmazás-hozzáférési tokenre és alkalmazáskulcsra, egy nyilvános HTTPS webhook végpontra, amely minden adatcsomag HMAC-SHA256 aláírását ellenőrzi, valamint HTTPS-en keresztül hitelesítés nélkül elérhető grafikai anyagokra. Mindhárom elemet a Fabrixa irányítópultján lehet kiadni vagy beállítani, és a hitelesítő adatok az értékesítési csatorna létrehozásakor azonnal generálódnak.
A 403-as hiba azt jelenti, hogy az alkalmazás-hozzáférési token és az alkalmazáskulcs érvényesek, de nincs jogosultságuk a kért erőforráshoz. Ez eltér a 401-es hibától, amely azt jelenti, hogy hiányzik egy kötelező fejléc, vagy a token érvényességét visszavonták; mindkettőt ellenőrizni lehet egy GET /ping kéréssel, mielőtt továbbhaladnánk a fejlesztéssel.
Integrációs támogatás, hitelesítő adatokkal vagy értékesítési csatornákkal kapcsolatos problémák, egyedi igények vagy kapacitástervezés esetén – forduljon a műszaki SE-csatornához, ne az értékesítési vonalhoz. Válasz egy munkanapon belül.
Kapcsolatot létesíthet a REST API szolgáltatásunkon és egy termékadat-feed segítségével, míg a Fabrixa Studio nevű tervezőszerkesztőnket beágyazhatja a saját platformjába, így az a saját funkciójaként jelenik meg.
Olvassa el a választ →Jelenleg fejlesztés alatt áll; csapatunk az automatizált megrendelés-beküldésen, a termékek, árak és készletek szinkronizálásán, valamint a visszaküldések automatikus nyomon követésén dolgozik.
Olvassa el a választ →Fejlesztői források: API dokumentáció https://www.fabrixa.com/developers/api-documentation · Integrációs útmutató https://www.fabrixa.com/developers/integration-guide/ · Webhookok https://api.fabrixa.com/docs/integration#webhooks
Olvassa el a választ →Az „Integrációk és API” témakörhöz tartozó mind a 8 válasz → Kérdezze meg ügyfélszolgálatunkat →
