Ugrás a fő tartalomra
A képernyőn megjelenő Fabrixa API kérés — JSON-formátumú megrendelési adatcsomag hitelesítési fejlécekkel, szőtt textíliára vonatkozóan
API dokumentáció

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.

REST · JSON · Webhookok · Studio beágyazás · Swagger

Mit kapsz

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.

01
Megrendelések
POST /v2/integration/orders

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.

02
Fulfilment
GET /orders/{id}/fulfillments

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.

03
Stúdió
iframe beágyazás

Á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.

04
Webhookok
order.created / order.updated

Két téma: HMAC-SHA256-tal aláírt hasznos adatok, teljes sorrendű test, 10-szeri újraküldés back-off-szabályozással.

Gyors útmutató

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 /v2/integration/orders
// 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"
  }
}
Integrációs folyamat

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.

01
Hitelesítő adatok

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.

02
Katalógus

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.

03
Megrendelések

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.

04
Webhookok

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.

05
Stúdió

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.

Fejlesztői források

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 →
Biztonság

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.

GYIK

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.

Kezdje el az építést!

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.

Tudásbázis

Kérdéseid vannak az integrációkkal és az API-vel kapcsolatban?

Az „Integrációk és API” témakörhöz tartozó mind a 8 válasz → Kérdezze meg ügyfélszolgálatunkat →