Fiecare versiune API. Fiecare modificare care afectează compatibilitatea. Înregistrate.
Fabrixa lansează versiunile API și actualizările platformei la intervale regulate. Fiecare versiune este publicată mai întâi aici — ce s-a schimbat, ce noutăți există, ce funcționalități vor fi retrase și când vor înceta efectiv să funcționeze. Verificați aici înainte de a efectua actualizarea.
Ce s-a schimbat în ultimele câteva săptămâni.
Cele mai recente mai întâi. Fiecare intrare este datată, etichetată conform standardului SemVer și împărțită în categoriile standard: Adăugat / Modificat / Depreciat / Eliminat / Remediat / Securitate.
- CHANGEDȘtiri de ultimă oră: calea de bază a fost mutată în
/v2/integration. Punctele de conectare v1 sunt înlocuite — integrările v1 existente vor continua să funcționeze pe durata perioadei de tranziție; consultați ghid de integrare. - CHANGEDȘtiri de ultimă oră: autentificarea se face acum prin două antete —
Authorization: Bearer(Token de acces la aplicație) plusX-Application-Key. Autentificarea v1 cu un singur token nu mai este acceptată. - ADDEDFabrixa Studio — instrument de personalizare a produselor de tip „white-label” care poate fi încorporat: încorporează-l prin iframe, atașează un design salvat la un rând din comandă cu ajutorul
cart_item_key, și extrage o previzualizare din/v2/studio/customizations/{key}/preview. - CHANGEDRăspuns standard privind criteriile de încheiere a listei:
links/meta/datacu linkuri de paginare. - CHANGEDWebhook-uri consolidate în
order.createdșiorder.updated, semnat cux-webhook-signature(HMAC-SHA256) și etichetat cux-webhook-topic. - CHANGEDLimita de rate a fost stabilită la 30 de solicitări pe aplicație pe minut, afișată prin intermediul
X-RateLimit-LimitșiX-RateLimit-Remainingantete.
- ADDED
GET /v1/products/:id/pricing— vizualizați prețurile unitare pentru fiecare nivel de volum, conform SKU. - CHANGEDConținutul webhook-ului de comandă include acum un
production_hubcâmp (PT, ES sau NL). Compatibil cu versiunile anterioare.
- ADDEDProces de personalizare în cinci etape pentru lenjerie de pat, fețe de masă și accesorii: text, nume, numere, imagini și câmpuri de date dinamice.
- ADDED
order.failedeveniment webhook cu motive de eroare structurate (respingerea imaginii, materialul nu este în stoc și altele similare). - FIXEDCaz extrem de paginare activat
GET /v1/ordersatunci când se filtrează după stare peste limitele paginilor.
- ADDEDPernă de exterior, față de masă și sac de relaxare SKUs, din material sintetic, pentru utilizare în aer liber. Disponibile prin intermediul
GET /v1/products?category=home-living. - DEPRECATED
artwork_base64câmpul din corpul comenzii — introduceți în schimb o adresă URL a fișierului sursă. Data eliminării: v1.20.0 (28 martie 2027). - SECURITYSistemul de semnare a webhook-urilor a fost consolidat. Varianta HMAC anterioară rămâne valabilă până la versiunea v1.18.0; de acum înainte, noul sistem de semnare se aplică automat.
- ADDEDCategoria „Lenjerie de pat” (huse de plapumă pentru 1 persoană / 2 persoane / paturi gemene, cuverturi de pat, cearșafuri cu elastic) pe platforma din Spania.
- ADDEDȘervețel prin sublimare SKUs pe platforma olandeză, cu un termen de livrare de 2–3 zile lucrătoare.
- CHANGEDPunctul final „Order” acceptă acum
recipient.countryca ISO 3166-1 alfa-2; varianta de rezervă alfa-3 a fost eliminată.
Versiuni mai vechi disponibile la cerere — e-mail developers@fabrixa.com.
SemVer, cu modificări care pot afecta compatibilitatea, aplicate cu prudență.
Modificări majore care afectează punctele de acces existente
Rar. Anunțat cu 12 luni înainte de lansare. Versiunea majoră anterioară rămâne compatibilă timp de 12 luni după lansarea noii versiuni majore. Nu renunțăm la versiunile majore fără o justificare întemeiată.
Noi puncte finale, câmpuri, comportamente
Adăugiri compatibile cu versiunile anterioare. Codul existent continuă să funcționeze fără modificări. Majoritatea versiunilor sunt minore, cu o frecvență de aproximativ două până la patru săptămâni.
Remedierea erorilor, performanță, securitate
Modificări care nu afectează funcționalitatea. Sunt implementate în mod continuu, fără anunț prealabil, și sunt consemnate în jurnalul de modificări după implementare.
12 luni de la anunțul de învechire până la eliminarea funcției.
Când marcăm ca învechit un câmp, un punct de acces sau un comportament, intrarea din jurnalul de modificări îl etichetează ca atare DEPRECATED și prezintă versiunea și data la care va fi eliminată. Funcționalitatea învechită va continua să funcționeze timp de cel puțin 12 luni de la data anunțului.
Trimitem trei notificări de reamintire — cu șase luni, trei luni și o lună înainte de eliminare — la adresa de e-mail înregistrată pentru cheia API.
Punctele finale învechite returnează, de asemenea, un X-Fabrixa-Deprecation antetul răspunsului care indică calea de migrare, astfel încât acesta să fie vizibil în jurnalele dvs.
Cum să ții evidența modificărilor.
Nu este nevoie să vă conectați la niciun flux de date — această pagină este sursa de informații de referință. Iată cum puteți fi mereu la curent cu tot ce afectează integrarea dumneavoastră.
Verifică mai întâi aici
Toate versiunile sunt publicate pe această pagină, cele mai recente fiind afișate în partea de sus. Adaugă-o la marcaje și verifică-o înainte de a actualiza o dependență sau de a lansa o nouă integrare.
O pistă liberă
Când un element este pe cale să fie retras, intrarea sa este marcată DEPRECATED împreună cu versiunea și data țintă pentru retragere — notificare prealabilă, în context.
Întrebați despre o modificare
Vă pregătiți pentru o schimbare sau pentru o migrare la o versiune majoră? Inginer de soluții vă poate explica detaliat calendarul și impactul integrării dumneavoastră.
Când pot fi lansate modificările care afectează compatibilitatea.
Lansările de versiuni majore sunt programate în anumite intervale de timp, astfel încât să nu coincidă cu datele de livrare către clienți sau cu perioadele de vârf ale vânzărilor cu amănuntul. În majoritatea anilor nu se înregistrează nicio lansare de versiune majoră.
Lunile februarie și septembrie reprezintă perioadele tipice pentru schimbări majore — ambele situându-se după sezonul principal de vânzări cu amănuntul și înainte de perioada de vârf, ceea ce le oferă integratorilor timp să efectueze migrarea înainte de următoarea livrare importantă.
Perioadele noiembrie–decembrie (vânzările de sărbători), martie–mai (Fespa și lansările de primăvară), precum și cele două săptămâni care preced evenimentele cunoscute din industrie sunt perioade în care nu se introduc modificări care afectează funcționalitatea. Lansările de patch-uri continuă, dar nu se introduc modificări minore sau majore ale comportamentului.
Departamentul de inginerie a soluțiilor îi ghidează pe integratori în depășirea principalelor obstacole.
Pentru trecerile la versiuni majore, publicăm un ghid de migrare împreună cu notele de lansare. Echipa de inginerie a soluțiilor organizează, de asemenea, sesiuni gratuite de consultanță privind migrarea, cu durata de 30 de minute, pentru orice partener de integrare activ, pe durata perioadei de retragere a versiunii vechi — programarea se face prin pagina „contact-engineer”. Clienții Enterprise beneficiază de asistență dedicată pentru migrare în cadrul contractului MSA, precum și de acces anticipat la noua versiune majoră pe un canal de vânzări de testare, cu 90 de zile înainte de disponibilitatea publică.
Verificați aici înainte de a efectua actualizarea.
Fiecare versiune este publicată mai întâi aici — ce s-a schimbat și când apare o eroare. Funcționalitățile învechite beneficiază de o perioadă de tranziție, iar trecerea la o versiune majoră este însoțită de asistență pentru migrare.