Minden API-kiadás. Minden kompatibilitást megszakító változás. Nyilvántartva.
Az Fabrixa rendszer előre kiszámítható ütemezés szerint bocsátja ki az API-t és a platformfrissítéseket. Minden kiadás először itt jelenik meg – mi változott, mi az újdonság, mi kerül kivezetésre, és mikor lép hatályon kívül. Frissítés előtt nézze meg itt!.
Mi változott az elmúlt néhány hétben?.
A legfrissebb bejegyzés az első. Minden bejegyzés dátummal és semver-címkével van ellátva, és a szokásos kategóriákra van felosztva: Hozzáadva / Módosítva / Elavult / Eltávolítva / Javítva / Biztonság.
- CHANGEDSürgős hír: az alapútvonal átkerült a
/v2/integration. A v1-es végpontok már nem támogatottak — a meglévő v1-es integrációk a kivezetési időszak alatt továbbra is működnek; lásd a bevezetési útmutató. - CHANGEDSürgős hír: A hitelesítés most már két fejlécből áll —
Authorization: Bearer(alkalmazás-hozzáférési token) pluszX-Application-Key. Az egy tokenes v1-es hitelesítés már nem elfogadott. - ADDEDFabrixa Studio — beágyazható, saját márkás termékkonfigurátor: beágyazás iframe-en keresztül, mentett terv hozzáadása egy megrendelési sorhoz a
cart_item_key, és töltsön be egy előnézetet a/v2/studio/customizations/{key}/preview. - CHANGEDA lista végpontjaira vonatkozó szabványos válaszboríték:
links/meta/dataoldalszámozási linkekkel. - CHANGEDA webhookok összevonva a
order.createdésorder.updated, aláírvax-webhook-signature(HMAC-SHA256) és a következő címkékkel ellátva:x-webhook-topic. - CHANGEDA kéréskorlátot alkalmazásonként percenként 30 kérésre állították be, amely a következő módon jelenik meg:
X-RateLimit-LimitésX-RateLimit-Remainingfejlécek.
- ADDED
GET /v1/products/:id/pricing— az SKU-nkénti mennyiségi szintek szerinti egységárak előzetes megtekintése. - CHANGEDA megrendelés webhook-adatcsomagja mostantól tartalmaz egy
production_hubmező (PT, ES vagy NL). Visszafelé kompatibilis.
- ADDEDÖtféle személyre szabási lehetőség ágyneműk, asztalterítékek és kiegészítők esetében: szöveg, név, számok, képek és dinamikus adatmezők.
- ADDED
order.failedwebhook-esemény strukturált hibaokokkal (grafikai elutasítás, szövet hiány, és hasonló okok). - FIXEDOldalszámozás – szélsőséges eset
GET /v1/ordersamikor az állapot szerint szűrünk az oldalak között.
- ADDEDKültéri párna, asztalterítő és ülőzsák SKUs szintetikus anyagból, kültéri használatra. Megvásárolható a
GET /v1/products?category=home-living. - DEPRECATED
artwork_base64mező a megrendelés törzsében — helyette adja meg a forrásfájl URL-jét. Törlési cél: v1.20.0 (2027.03.28.). - SECURITYA webhook aláírási rendszer biztonságát megerősítették. A korábbi HMAC-változat a v1.18.0 verzióig érvényben marad; a jövőben az új aláírási módszer automatikusan kerül alkalmazásra.
- ADDEDÁgynemű-kategória (paplanhuzatok 1P / 2P / Lits Jumeaux, ágytakarók, gumiszegélyes lepedők) a spanyol webáruházban.
- ADDEDSKUs szublimációs szalvéta a holland elosztóközpontból, 2–3 munkanapos szállítási határidővel.
- CHANGEDAz „Endpoint” megrendelés most már elfogadja
recipient.countryISO 3166-1 alfa-2 kódként; az alfa-3 tartalék kódot eltávolították.
Régebbi kiadások kérésre elérhetők — e-mailben developers@fabrixa.com.
SemVer, konzervatív kompatibilitási változásokkal.
A meglévő végpontok működését érintő változások
Ritka. A kiadás előtt 12 hónappal bejelentik. A régi főverziót az új főverzió megjelenését követően még 12 hónapig támogatják. Nem szüntetjük meg könnyelműen a főverziókat.
Új végpontok, mezők, viselkedés
Visszafelé kompatibilis új funkciók. A meglévő kód módosítás nélkül továbbra is működik. A legtöbb kiadás kisebb frissítés, nagyjából két-négy hetes gyakorisággal.
Hibajavítások, teljesítmény, biztonság
Kizárólag nem töréses változás. Előzetes bejelentés nélkül, folyamatosan kerülnek bevezetésre, és a bevezetés után kerülnek rögzítésre a változásnaplóban.
12 hónap telik el a kivezetésről szóló értesítés és a kivezetés között.
Amikor egy mezőt, végpontot vagy viselkedést elavulttá nyilvánítunk, a változásnapló-bejegyzés megjelöli azt DEPRECATED és feltünteti a kivonásra kerülő verziót és dátumot. A kivezetett funkció a bejelentést követően még legalább 12 hónapig működni fog.
Három emlékeztető értesítést küldünk – hat hónappal, három hónappal és egy hónappal az eltávolítás előtt – a API kulcshoz nyilvántartásba vett e-mail-címre.
A már nem támogatott végpontok szintén egy X-Fabrixa-Deprecation a migrációs útvonalra mutató válaszfejléc, így az a naplófájlokban is látható lesz.
Hogyan lehet nyomon követni a változásokat?.
Nincs szükség hírcsatornák bekötésére — ez az oldal a legmegbízhatóbb forrás. Íme, hogyan tarthatod kézben az integrációdat érintő minden fejleményt.
Először itt nézze meg
Minden kiadás felkerül erre az oldalra, a legfrissebbek a legfelső sorban. Jegyezd be a könyvjelzőid közé, és nézd át, mielőtt frissítenél egy függőséget vagy kiadnál egy új integrációt.
Egy szabad kifutópálya
Amikor egy elem kifutóban van, a bejegyzését megjelölik DEPRECATED a eltávolítandó célverzió és dátum megadásával — előzetes értesítés, a kontextusban.
Érdeklődjön a módosításról
Változást vagy főverzió-átállást tervez? Megoldás-mérnök áttekintést adhat az integráció időzítéséről és hatásairól.
Mikor kerülhetnek kiadásra a kompatibilitást megszakító változások.
A főverzió-kiadások időzítését úgy tervezik meg, hogy azok ne esjenek egybe az ügyfelek frissítési határidőivel vagy a kiskereskedelmi csúcsidőszakokkal. A legtöbb évben egyáltalán nem jelenik meg főverzió-kiadás.
Február és szeptember a tipikus átállási időszakok – mindkettő a fő kiskereskedelmi szezon után, mind pedig a csúcsidőszak előtt esik, ami időt biztosít a rendszerintegrátoroknak az átállásra a következő nagy termékbevezetés előtt.
November–december (ünnepi értékesítési időszak), március–május (Fespa és tavaszi újdonságok), valamint az ismert iparági események előtti két hét olyan időszakok, amikor nem kerül sor jelentős változtatásokra. A javítások továbbra is megjelennek, de sem kisebb, sem nagyobb viselkedésbeli változások nem történnek.
A megoldás-tervezés végigvezeti a rendszerintegrátorokat a legfontosabb nehézségeken.
A főverzió-váltások esetén a kiadási megjegyzések mellett migrációs útmutatót is közzéteszünk. A megoldásfejlesztési csapat emellett ingyenes, 30 perces migrációs konzultációs időpontokat biztosít minden aktív integrációs partner számára a kivezetési időszak alatt – a foglalás a „contact-engineer” oldalon lehetséges. Az Enterprise ügyfelek dedikált migrációs támogatást kapnak az MSA-juk keretében, valamint 90 nappal a nyilvános elérhetőség előtt korai hozzáférést az új főverzióhoz egy staging értékesítési csatornán keresztül.
A frissítés előtt nézze meg ezt.
Minden új verzió először itt jelenik meg — mi változott, és mikor okozhat hibát. A kivezetett funkciók átmeneti időszakot kapnak, a főverzió-váltásokhoz pedig áttérési támogatás jár.