Adjon le egy megrendelést, amely tartalmazza a sorokat, a forrás PDF-fájlokat, az ügyfél adatait és a szállítási címet. Visszaadja az Fabrixa megrendelési azonosítót. Opcionális szállítási címke és nyomonkövetési mezők.
Egy végpont. Végtelen sok termék.
Minden Fabrixa és SKU, minden szövet, minden felületkezelés — egyetlen, dokumentált REST API-n keresztül elérhető. JSON bemenet, JSON kimenet. Webhookok minden állapotváltozáshoz. Önkiszolgáló API-kulcsok — hozzon létre egy értékesítési csatornát, és kezdjen el fejleszteni.
A gyártás tényleges működési módjára épül.
Egy dokumentált REST API, amely tükrözi a platform működését – megrendelések, teljesítés, Studio testreszabás és webhookok. JSON be, JSON ki. Használhatod a vezérlőpulttal együtt, vagy programozással is vezérelheted az egészet.
Gyártási állapot lekérése tételenként: minden lépés (nyomtatás, javítás, mosás, varrás) a „függőben”, „folyamatban”, „befejezve” és „elutasítva” állapotokkal. Vagy iratkozzon fel a webhookokra a push-értesítésekhez.
Ágyazza be az Fabrixa Studio alkalmazást az online áruházába! A vásárlók valós időben testreszabhatják a termékeket: a „kosárba helyezés” és a „vissza” műveletekhez postMessage események állnak rendelkezésre, valamint a kosárban lévő termékek miniatűrjeinek megtekintéséhez egy előnézeti URL-cím is rendelkezésre áll.
Két téma: HMAC-SHA256-tal aláírt hasznos adatok, teljes sorrendű test, 10-szeri újraküldés back-off-szabályozással.
Adja le a megrendelést egyetlen POST-kérésben.
Hitelesített kérés, érvényesített adatcsomag, helyfoglalás a termelési sorban. Visszaigazolás milliszekundumok alatt — az ügyfél megrendelése már feldolgozás alatt áll.
A teljes sémakép, az összes végpont, a hibakódok, a kéréskorlátozások és az integrációs példák a technikai dokumentációban találhatók.
// POST https://api.fabrixa.com/v2/integration/orders // Authorization: Bearer APPLICATION_ACCESS_TOKEN // X-Application-Key: APPLICATION_KEY { "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" } }
Két hét múlva indul. Nincs proxy, nincs közbenső szoftver.
Közvetlen REST-integráció a platformjába. Nincs szükség SDK-ra, proxy-kiszolgálóra vagy harmadik féltől származó csatlakozóra. Szabványos HTTP-kapcsolat a rendszerétől a miénkig.
Szerezzen be egy alkalmazás-hozzáférési tokent és egy alkalmazáskulcsot úgy, hogy létrehoz egy értékesítési csatornát a vezérlőpulton. Mindkettőre szükség van minden kérésnél: a Bearer token az Authorization mezőben, az alkalmazáskulcs pedig az X-Application-Key mezőben.
Fedezze fel az élő Swagger-referenciát, hogy megtalálja az eladni kívánt termékekhez tartozó SKUs változatokat, valamint a szűrési és oldalszámozási mintákat.
A fizetés során küldj el egy POST-kérést, amely tartalmazza a sorokat, a forrásokat (PDF-URL-eket), az ügyfél adatait és a szállítási címet. A visszaküldött Fabrixa megrendelési azonosítót tárold el a saját megrendelési hivatkozásod mellett.
Hozzon létre egy nyilvános POST végpontot. Minden adatcsomagot HMAC-SHA256-tal (x-webhook-signature) aláírunk, így a feldolgozás előtt ellenőrizheti azok hitelességét.
Opcionális: illessze be a Fabrixa Studio iframe-jét a termékoldalára. Az ügyfelek az oldalon közvetlenül személyre szabhatják a terméket; a személyre szabott beállításokat POST-kéréssel csatolhatják a megrendeléshez.
Minden, amire a mérnöki csapatodnak szüksége van.
Teljes API referencia
Teljes körű végpont-dokumentáció, kérés/válasz sémák, hibakódok, sebességkorlátozások, hitelesítés, Studio-beágyazás és webhook-szerződések – élő Swagger-felülettel.
Dokumentumok megnyitása →Egy értékesítési csatornához igazodva történő fejlesztés
Hozzon létre egy külön értékesítési csatornát, amelyre építhet – küldjön be próba megrendeléseket, ellenőrizze a webhookok kézbesítését, tesztelje a szélsőséges eseteket –, majd irányítsa az éles csatornára a valódi forgalmat. A kulcsai már a csatorna létrehozásának pillanatában készen állnak – nincs szükség külön kérésre.
Fiók létrehozása →Postman-gyűjtemény
Előre konfigurált kérelemgyűjtemény példaadatokkal és hitelesítéssel. Importáld a tesztelési munkafolyamatodba!.
Szerezd be a kollekciót →Kétfejű hitelesítés. Aláírt webhookok. Forgalomkorlátozás.
Szabványos eljárások, nincsenek meglepetések. Minden kérést Bearer-token és alkalmazáskulcs segítségével hitelesítünk. Minden webhookot HMAC-aláírással látunk el az ellenőrzés érdekében, és alkalmazásonként előre kiszámítható forgalmi korlátok vannak érvényben.
Alkalmazás-hozzáférési token
Az Authorization fejlécben szereplő hordozó token. A hívó alkalmazást azonosítja.
Alkalmazáskulcs
Az X-Application-Key fejlécben kerül elküldésre. Mindkettő kötelező minden kérésnél — ha bármelyik hiányzik, 401-es hibakódot ad vissza.
TLS-titkosítás
Az api.fabrixa.com oldalon kizárólag HTTPS használható. A sima szöveges kéréseket a hálózati peremen elutasítják.
Webhook-aláírások
Minden webhookot HMAC-SHA256-tal aláírnak, és az x-webhook-signature fejlécben küldik el. A feldolgozás előtt ellenőrizd le!.
Folyamatkorlátozások
Alkalmazásonként 30 kérés percenként. Az X-RateLimit-Limit és az X-RateLimit-Remaining értékeket minden válaszban visszaadjuk.
Webhook-újrapróbálkozások
Legfeljebb 10 kézbesítési kísérlet 2xx-től vagy 3xx-től eltérő válasz esetén. A webhook a 10. sikertelen kísérlet után deaktiválódik.
Az „Integration API” kérdésre adott válasz
Hogyan tudok bejelentkezni az Fabrixa és az API készülékeken?
Minden kéréshez két fejléc szükséges: egy alkalmazás-hozzáférési token, amelyet „Bearer” tokenként kell elküldeni az „Authorization” fejlécben, valamint egy alkalmazáskulcs az „X-Application-Key” fejlécben. Mindkettő akkor generálódik, amikor létrehozol egy értékesítési csatornát az Fabrixa irányítópulton, és ha bármelyik fejléc hiányzik, a kérés 401-es hibakóddal kerül elutasításra.
Kipróbálhatom az Fabrixa és az API stratégiákat, mielőtt valódi megbízásokat adnék le?
Igen — hozzon létre egy külön értékesítési csatornát, amelyre építhet, küldjön be tesztmegrendeléseket, ellenőrizze a webhookok kézbesítését és tesztelje a szélsőséges eseteket, majd amint minden működik, irányítsa az éles forgalmat az éles csatornára. A csatorna regisztrációja és létrehozása révén az alkalmazás-hozzáférési tokenje és az alkalmazáskulcsa azonnal elérhetővé válik, külön kérés nélkül.
A Fabrixa-integráció HTTPS-sel titkosított API-e?
Igen — az API az api.fabrixa.com oldalon kizárólag HTTPS-en keresztül érhető el, és minden sima szöveges kérést már a hálózati peremen elutasít. Minden kérés hitelesítése Bearer token és alkalmazáskulcs segítségével történik, és minden webhook-adatcsomagot HMAC-SHA256-tal aláírnak, így azok feldolgozás előtt ellenőrizhetők.
Mit ad vissza egy /v2/integration/orders címre küldött POST-kérés?
Egy hitelesített POST-kérés a /v2/integration/orders végponthoz ellenőrzi a kérés tartalmát, helyet foglal a termelési sorban, majd milliszekundumokban megadja az Fabrixa megrendelési azonosítót tartalmazó visszaigazolást, valamint – opcionálisan – a szállítási címkét és a nyomonkövetési mezőket. A teljesítés ezután tételenként nyomon követhető, vagy webhookokon keresztül továbbítható az Ön felé.
Szükségem van SDK-ra vagy proxynak az Fabrixa és API integrálásához?
Nem — az fabrixa integrációja egy közvetlen REST-kapcsolat a szabványos HTTP-n keresztül, amelyhez nincs szükség SDK-ra, proxy-kiszolgálóra vagy harmadik féltől származó csatlakozóra. Az fabrixa-t közvetlenül a saját rendszeréből hívja meg JSON-kérések és -válaszok segítségével, az állapotváltozásokról pedig webhookok értesítik.
Hozzon létre egy értékesítési csatornát, és kezdje el még ma a felépítését!.
Regisztráljon, hozzon létre egy értékesítési csatornát, és a API-hozzáférési adatai azonnal rendelkezésre állnak. Segítségre van szüksége? Megoldás-mérnökeink 24 órán belül válaszolnak — a legtöbb csapat két héten belül már működőképes.


