Κάθε έκδοση του API. Κάθε αλλαγή που επιφέρει ασυμβατότητα. Καταγράφεται.
Το Fabrixa κυκλοφορεί τις εκδόσεις API και τις ενημερώσεις της πλατφόρμας με σταθερό χρονικό ρυθμό. Κάθε έκδοση δημοσιεύεται πρώτα εδώ — τι έχει αλλάξει, τι είναι καινούργιο, τι καταργείται και πότε θα σταματήσει να λειτουργεί. Ελέγξτε εδώ πριν προχωρήσετε στην αναβάθμιση.
Τι άλλαξε τις τελευταίες εβδομάδες.
Πρώτα τα πιο πρόσφατα. Κάθε καταχώριση φέρει ημερομηνία, ετικέτα semver και χωρίζεται στις τυπικές κατηγορίες: Προστέθηκε / Τροποποιήθηκε / Καταργήθηκε / Διορθώθηκε / Ασφάλεια.
- CHANGEDΕκτάκτο: η διαδρομή βάσης μεταφέρθηκε στο
/v2/integration. Τα σημεία τερματισμού της έκδοσης v1 έχουν καταργηθεί — οι υπάρχουσες ενσωματώσεις της έκδοσης v1 θα συνεχίσουν να λειτουργούν κατά τη διάρκεια της περιόδου κατάργησης· ανατρέξτε στο οδηγός ενσωμάτωσης. - CHANGEDΕκτάκτο: η πιστοποίηση αποτελείται πλέον από δύο κεφαλίδες —
Authorization: Bearer(Διακριτικό πρόσβασης εφαρμογής) συνX-Application-Key. Η πιστοποίηση v1 με ένα μόνο token δεν γίνεται πλέον αποδεκτή. - ADDEDFabrixa Studio — εργαλείο προσαρμογής προϊόντων «white-label» με δυνατότητα ενσωμάτωσης: ενσωμάτωση μέσω iframe, προσθήκη αποθηκευμένου σχεδίου σε μια γραμμή παραγγελίας με
cart_item_key, και να δείτε μια προεπισκόπηση από/v2/studio/customizations/{key}/preview. - CHANGEDΤυπική απόκριση σχετικά με τα οριακά σημεία της λίστας:
links/meta/dataμε συνδέσμους σελιδοποίησης. - CHANGEDΤα webhooks συγκεντρώθηκαν στο
order.createdκαιorder.updated, υπογεγραμμένο μεx-webhook-signature(HMAC-SHA256) και με ετικέταx-webhook-topic. - CHANGEDΤο όριο αριθμού αιτήσεων έχει οριστεί σε 30 αιτήσεις ανά εφαρμογή ανά λεπτό, όπως εμφανίζεται μέσω
X-RateLimit-LimitκαιX-RateLimit-Remainingεπικεφαλίδες.
- ADDED
GET /v1/products/:id/pricing— Προεπισκόπηση των τιμών ανά μονάδα για κάθε επίπεδο όγκου σύμφωνα με το SKU. - CHANGEDΤο περιεχόμενο του webhook «Order» περιλαμβάνει πλέον ένα
production_hubπεδίο (PT, ES ή NL). Συμβατότητα με παλαιότερες εκδόσεις.
- ADDEDΔιαδικασία εξατομίκευσης πέντε τύπων για κλινοσκεπάσματα, τραπεζομάντιλα και αξεσουάρ: κείμενο, όνομα, αριθμοί, εικόνες και δυναμικά πεδία δεδομένων.
- ADDED
order.failedσυμβάν webhook με δομημένους λόγους σφάλματος (απόρριψη εικόνας, εξάντληση αποθεμάτων υφάσματος και παρόμοια). - FIXEDΕιδική περίπτωση σελιδοποίησης σχετικά με
GET /v1/ordersόταν γίνεται φιλτράρισμα βάσει κατάστασης που εκτείνεται σε περισσότερες από μία σελίδες.
- ADDEDΜαξιλάρι εξωτερικού χώρου, τραπεζομάντιλο και σάκος καθίσματος SKUs για χρήση σε εξωτερικούς χώρους από συνθετικό υλικό. Διατίθεται μέσω
GET /v1/products?category=home-living. - DEPRECATED
artwork_base64πεδίο στο σώμα της παραγγελίας — εισάγετε αντ' αυτού τη διεύθυνση URL του αρχείου προέλευσης. Προγραμματισμένη κατάργηση: v1.20.0 (28/03/2027). - SECURITYΕνισχύθηκε το σύστημα υπογραφής webhook. Η προηγούμενη παραλλαγή HMAC παραμένει σε ισχύ έως την έκδοση v1.18.0· από εδώ και στο εξής, η νέα μέθοδος υπογραφής εφαρμόζεται αυτόματα.
- ADDEDΚατηγορία κλινοσκεπασμάτων (κάλυμματα παπλωμάτων για 1 άτομο / 2 άτομα / διπλά κρεβάτια, καλύμματα κρεβατιού, σεντόνια με λάστιχο) στον ισπανικό κόμβο.
- ADDEDΠετσέτα εξάχνωσης SKUs στον ολλανδικό κόμβο με χρόνο παράδοσης 2–3 εργάσιμες ημέρες.
- CHANGEDΤο σημείο τερματισμού παραγγελιών δέχεται πλέον
recipient.countryως ISO 3166-1 alpha-2· η εναλλακτική μορφή alpha-3 καταργήθηκε.
Παλαιότερες εκδόσεις διατίθενται κατόπιν αιτήματος — στείλτε email developers@fabrixa.com.
SemVer, με συντηρητικές αλλαγές που προκαλούν ασυμβατότητα.
Σημαντικές αλλαγές σε υπάρχοντα σημεία τερματισμού
Σπάνιο. Ανακοινώνεται 12 μήνες πριν από την κυκλοφορία. Η παλιά κύρια έκδοση συνεχίζει να υποστηρίζεται για 12 μήνες μετά την κυκλοφορία της νέας κύριας έκδοσης. Δεν καταργούμε τις κύριες εκδόσεις ελαφρά τη καρδία.
Νέα τελικά σημεία, πεδία, συμπεριφορά
Προσθήκες με συμβατότητα προς παλαιότερες εκδόσεις. Ο υπάρχων κώδικας συνεχίζει να λειτουργεί χωρίς αλλαγές. Οι περισσότερες εκδόσεις είναι δευτερεύουσες και κυκλοφορούν περίπου κάθε δύο έως τέσσερις εβδομάδες.
Διορθώσεις σφαλμάτων, απόδοση, ασφάλεια
Αποκλειστικά μη διακοπτόμενη λειτουργία. Εφαρμόζεται συνεχώς χωρίς προηγούμενη ανακοίνωση και καταγράφεται στο αρχείο αλλαγών μετά την εφαρμογή.
12 μήνες από την ανακοίνωση κατάργησης έως την αφαίρεση.
Όταν καταργούμε ένα πεδίο, ένα σημείο τερματισμού ή μια συμπεριφορά, η αντίστοιχη καταχώριση στο αρχείο αλλαγών το επισημαίνει DEPRECATED και αναγράφει την έκδοση και την ημερομηνία κατάργησης. Η λειτουργικότητα που έχει καταργηθεί θα συνεχίσει να λειτουργεί για τουλάχιστον 12 μήνες μετά την ανακοίνωση.
Στέλνουμε τρεις ειδοποιήσεις υπενθύμισης — έξι μήνες, τρεις μήνες και έναν μήνα πριν από την κατάργηση — στη διεύθυνση ηλεκτρονικού ταχυδρομείου που έχει καταχωρηθεί για το κλειδί API.
Τα καταργημένα σημεία τερματισμού επιστρέφουν επίσης ένα X-Fabrixa-Deprecation κεφαλίδα απόκρισης που υποδεικνύει τη διαδρομή μετεγκατάστασης, ώστε να είναι ορατή στα αρχεία καταγραφής σας.
Πώς να παρακολουθείτε τις αλλαγές.
Δεν χρειάζεται να συνδέσετε καμία τροφοδοσία — αυτή η σελίδα είναι η μοναδική αξιόπιστη πηγή πληροφοριών. Δείτε πώς μπορείτε να είστε πάντα ενήμεροι για οτιδήποτε επηρεάζει την ενσωμάτωσή σας.
Δείτε πρώτα εδώ
Κάθε έκδοση εμφανίζεται σε αυτή τη σελίδα, με την πιο πρόσφατη να βρίσκεται στην κορυφή. Προσθέστε τη στα αγαπημένα σας και ρίξτε μια ματιά πριν αναβαθμίσετε μια εξάρτηση ή κυκλοφορήσετε μια νέα ενσωμάτωση.
Ένας ελεύθερος διάδρομος προσγείωσης
Όταν κάτι καταργείται, η καταχώρισή του επισημαίνεται DEPRECATED με την έκδοση-στόχο και την ημερομηνία κατάργησης — προειδοποίηση εκ των προτέρων, στο πλαίσιο.
Ρωτήστε για μια αλλαγή
Σχεδιάζετε μια αλλαγή ή τη μετάβαση σε νέα κύρια έκδοση; Ένας μηχανικός λύσεων μπορεί να σας εξηγήσει λεπτομερώς το χρονοδιάγραμμα και τις επιπτώσεις της ενσωμάτωσής σας.
Πότε μπορούν να κυκλοφορήσουν αλλαγές που προκαλούν ασυμβατότητα.
Οι κυκλοφορίες νέων κύριων εκδόσεων προγραμματίζονται σε συγκεκριμένα χρονικά διαστήματα, ώστε να μην συμπίπτουν με τις ημερομηνίες κυκλοφορίας των προϊόντων των πελατών ή με τις περιόδους αιχμής των λιανικών πωλήσεων. Τα περισσότερα χρόνια δεν πραγματοποιούνται κυκλοφορίες νέων κύριων εκδόσεων.
Ο Φεβρουάριος και ο Σεπτέμβριος είναι οι τυπικές περίοδοι για σημαντικές αλλαγές — και οι δύο μετά τη μεγάλη περίοδο λιανικών πωλήσεων και πριν από την περίοδο αιχμής, γεγονός που δίνει στους ολοκληρωτές συστημάτων χρόνο να πραγματοποιήσουν τη μετάβαση πριν από την επόμενη μεγάλη πτώση των πωλήσεων.
Νοέμβριος–Δεκέμβριος (εορταστικές πωλήσεις), Μάρτιος–Μάιος (Fespa και ανοιξιάτικες κυκλοφορίες) καθώς και οι δύο εβδομάδες πριν από γνωστές εκδηλώσεις του κλάδου αποτελούν περιόδους κατά τις οποίες δεν επιτρέπονται αλλαγές που θα προκαλέσουν διακοπή της λειτουργίας. Οι εκδόσεις ενημερώσεων συνεχίζονται, αλλά δεν πραγματοποιούνται μικρές ή σημαντικές αλλαγές στη λειτουργία.
Η ομάδα τεχνικών λύσεων καθοδηγεί τους ολοκληρωτές κατά τη διάρκεια των σημαντικότερων δυσκολιών.
Για τις αλλαγές σε κύριες εκδόσεις, δημοσιεύουμε έναν οδηγό μετάβασης μαζί με τις σημειώσεις έκδοσης. Η ομάδα Solutions Engineering διοργανώνει επίσης δωρεάν 30λεπτες συνεδρίες υποστήριξης για τη μετάβαση, για κάθε ενεργό συνεργάτη ενσωμάτωσης κατά τη διάρκεια της περιόδου κατάργησης — κάντε κράτηση μέσω της σελίδας «contact-engineer». Οι εταιρικοί πελάτες λαμβάνουν εξειδικευμένη υποστήριξη μετεγκατάστασης στο πλαίσιο της MSA τους, καθώς και πρόωρη πρόσβαση στη νέα κύρια έκδοση μέσω ενός δοκιμαστικού καναλιού πωλήσεων 90 ημέρες πριν από τη δημόσια διάθεσή της.
Δείτε εδώ πριν προχωρήσετε στην αναβάθμιση.
Κάθε νέα έκδοση δημοσιεύεται πρώτα εδώ — τι άλλαξε και πότε παρουσιάζει σφάλματα. Οι καταργήσεις λειτουργιών συνοδεύονται από μια μεταβατική περίοδο, ενώ οι αλλαγές στην κύρια έκδοση συνοδεύονται από υποστήριξη μετεγκατάστασης.