01
A gyűjtemény importálása
A Postman alkalmazásban: File → Import → Link. Illessze be a fenti letöltés gombon található JSON-URL-t. A Postman hozzáadja a gyűjteményt – a változóival együtt – a munkaterületéhez.
Fejlesztők · Postman-gyűjtemény
Töltsd be a gyűjteményt! Öt perc alatt érj el egy API-t!.
Egy előre összeállított Postman-gyűjtemény, gyakorlati példákkal a Fabrixa és a API integrációjához. Csak írd be a hitelesítő adataidat, kattints végig a kéréseken, és nézze meg a API-re érkező valós válaszokat, még mielőtt egyetlen sor integrációs kódot is írnál. Verziókövetés – a gyűjtemény frissül, amikor a API is frissül.
Mi található a gyűjteményben?
Minden végpont, példaadatokkal.
Forrásonként mappákba rendezve. Minden kéréshez tartozik egy kidolgozott példa a kérés szövegében, az előre beállított két hitelesítési fejléc, valamint egy elmentett példaválasz – így a kérés elküldése előtt megtekintheted a válasz szerkezetét.
Hitelesítés és termékek
- GET /ping — hitelesítő adatok ellenőrzése
- GET /products — lista és oldalszámozás (SKU + variant_id)
- Teljes mezővázlatok a Swagger-referenciában
Megrendelések
- BEKÜLDÉS /orders — megrendelés létrehozása
- GET /orders/{id}/fulfillments — a gyártás nyomon követése
Stúdió és webhookok
- GET /v2/studio/customizations/{key}/preview
- Webhook-adatcsomag + HMAC-ellenőrzés (példa)
Importálás 30 másodperc alatt
Fájl → Importálás → Hivatkozás → URL beillesztése.
02
Nyissa meg a „Változók” fület
A gyűjtemény saját változókkal rendelkezik — base_url előre kitöltve van; access_token és application_key ezek helyőrzők. Nincs szükség külön környezeti fájlra.
03
Illessze be a kulcsait
Illessze be a műszerfalon egy értékesítési csatornához tartozó alkalmazás-hozzáférési tokent és alkalmazáskulcsot, kattintson a „Mentés” gombra, és ezután minden kérés hitelesítésre kerül.
Környezeti változók
Mi szerepel az env fájlban?.
Egy alap-URL, két hitelesítő adat, beépítve a gyűjteménybe. Készítsd el egy értékesítési csatornára, majd a kiadáskor illeszd be az éles csatornád kulcsait – ugyanaz a gyűjtemény, ugyanazok a kérések.
Gyűjtési változók
{
"base_url": "https://api.fabrixa.com/v2/integration",
"studio_base": "https://api.fabrixa.com/v2/studio",
"access_token": "APPLICATION_ACCESS_TOKEN",
"application_key": "APPLICATION_KEY"
}
A hitelesítés előre be van állítva
Mindkét hitelesítési fejléc minden kérésnél előre be van állítva.
Minden kérés magában hordozza Authorization: Bearer {{access_token}} és X-Application-Key: {{application_key}}, a gyűjteményváltozókból merítve — nincs szükség kérésenkénti fejlécbeállításra. Az egyik értékesítési csatornáról a másikra való átálláshoz csupán ezt a két változót kell módosítani: ugyanaz a gyűjtemény, csak más kulcsok.
Példák megoldással
Minden kéréshez tartozik egy minta-test és egy elmentett válasz.
A gyűjtemény nem csupán URL-csonkokból áll – minden kéréshez tartozik egy kidolgozott példa, így a „Küldés” gombra kattintva valódi adatokat láthatsz. A mentett példaválaszok az „Példák” panelen találhatók, hogy offline is hozzáférhess hozzájuk.
Hitelesítés ellenőrzése
Először is ellenőrzi, hogy az alkalmazás hozzáférési tokenje és az alkalmazáskulcsa érvényesek-e. Siker esetén 200-as kódot ad vissza, fejléc hiányában pedig 401-et.
Termékek listája
Oldalszámozott katalóguslekérés. A termékeket oldalanként adja vissza a /meta/data burkolatban található linkekben, tételenként a SKU azonosítóval és a változat azonosítójával együtt.
Megrendelés létrehozása
Példa egy darabos póló megrendelésre, forrás PDF-fájllal, ügyfél- és szállítási címmel. Kattintson a „Küldés” gombra, hogy megtekintse a létrehozott megrendelést a Fabrixa azonosítóval.
Termelés nyomon követése
Egy leadott megrendeléshez tartozó, tételenkénti gyártási lépéseket (nyomtatás, rögzítés, mosás, varrás) jeleníti meg a „függőben”, „folyamatban”, „befejezve” és „elutasítva” állapotokkal.
Stúdió-előzetes
Visszaadja egy mentett Studio-testreszabás renderelt előnézeti képét — ezt közvetlenül beillesztheted a kosár miniatűrjébe.
Aláírás-ellenőrzés
Egy gyakorlati példa a HMAC-SHA256 aláírás újraszámítására és annak az x-webhook-signature értékkel való összehasonlítására a feldolgozás előtt.
Verziókezelés
A gyűjtemény akkor frissül, amikor a API is frissül.
Minden API-kiadás egy frissített gyűjteményt tesz közzé ugyanazon az URL-címen. Az új végpontok és példa-payloadok beolvasásához végezzen újbóli importálást — a mentett verzióban található meglévő kérések addig továbbra is működnek, amíg az adott végpont ténylegesen elavulttá nem válik.
Állandó URL-cím
A gyűjtemény JSON-URL-je állandó. Az újbóli importáláskor a legfrissebb verzió kerül betöltésre — az URL a kiadások között soha nem változik.
Változásnapló-hivatkozás
Lásd a változásnapló a kapcsolódó API verziójegyzetekhez – mi változott, mi került hozzáadásra, mi válik elavulttá.
Elavult funkciókra vonatkozó irányelv
Az endpointok 12 hónapos kivezetési időszakot kapnak. A gyűjtemény a leírásban jelzi a kivezetésre kerülő kéréseket, így azok nehezen maradhatnak észrevétlenek, mielőtt bármilyen hiba lépne fel.
GYIK
A „Postás” gyűjtemény – válaszok
Hogyan importálhatom a Fabrixa Postman-gyűjteményt?
A Postman alkalmazásban válaszd a „Fájl” menüpontot, majd az „Importálás” és a „Link” lehetőségeket, végül illeszd be a gyűjtemény JSON-URL-jét. A Postman hozzáadja a gyűjteményt és annak változóit a munkaterületedhez — a „base_url” mező előre kitöltve van, míg az „access_token” és az „application_key” helyőrzők, amelyeket a saját alkalmazás-hozzáférési tokeneddel és alkalmazáskulcsoddal kell helyettesítened.
Mely végpontok szerepelnek a Fabrixa Postman-gyűjteményben?
A gyűjtemény tartalmazza a GET /ping parancsot a hitelesítő adatok ellenőrzéséhez, a GET /products parancsot a katalógus felsorolásához és oldalozásához, a POST /orders parancsot megrendelés létrehozásához, a GET /orders/{id}/fulfillments parancsot a gyártás nyomon követéséhez, a Studio előnézeti végpontot, valamint egy működő webhook-aláírás-ellenőrzési példát. A gyűjtemény a v2 Integration API verzióhoz készült, és a Postman v10 vagy újabb verzióját igényli.
Hogyan van beállítva a hitelesítés az Fabrixa Postman-gyűjteményben?
A gyűjteményben szereplő minden kérés már tartalmazza a két kötelező fejléceket — Authorization: Bearer {{access_token}} és X-Application-Key: {{application_key}} —, amelyeket a gyűjtemény változóiból vesznek át. Az alkalmazás-hozzáférési token és az alkalmazáskulcs beillesztése ezekbe a változókba egyszerre hitelesíti az összes kérést, anélkül, hogy kérésenként beállítást kellene végezni.
A Fabrixa Postman-gyűjtemény frissül-e, ha a API változik?
Igen — minden API-kiadás egy frissített gyűjteményt tesz közzé ugyanazon az állandó URL-címen, így az újbóli importálás során a rendszer letölti a legfrissebb végpontokat és példaadatcsomagokat. A végpontokra 12 hónapos kivezetési időszak vonatkozik, és a gyűjtemény leírásában jelzi a kivezetett kéréseket, mielőtt bármilyen működési zavar lépne fel.
Mit ad vissza a GET /orders/{id}/fulfillments kérés?
A rendszer lekérdezi a leadott megrendelés egyes tételeinek gyártási állapotát, beleértve az olyan lépéseket, mint a nyomtatás, a javítás, a mosás és a varrás, amelyek mindegyike „függőben”, „folyamatban”, „befejezve” vagy „elutasítva” állapotban jelenik meg. A Postman-gyűjtemény tartalmaz egy gyakorlati példát, így a válasz formátuma ellenőrizhető, mielőtt azt beépítenék egy integrációba.
Letöltés és indítás
Töltsd le a gyűjteményt! Küldd el az első lekérdezésedet!.
Importálja a gyűjteményt, adja meg az értékesítési csatorna hitelesítő adatait, és perceken belül küldje el az első kérését — a felfedezéshez nincs szükség integrációs kódra.