01
Εισαγωγή της συλλογής
Στο Postman: File → Import → Link. Επικολλήστε τη διεύθυνση URL του αρχείου JSON από το παραπάνω κουμπί λήψης. Το Postman προσθέτει τη συλλογή — μαζί με τις μεταβλητές της — στον χώρο εργασίας σας.
Προγραμματιστές · Συλλογή Postman
Εισάγετε τη συλλογή. Φτάστε στο API σε πέντε λεπτά.
Μια έτοιμη συλλογή Postman με παραδείγματα σε εφαρμογή για την ενσωμάτωση Fabrixa στο API. Εισάγετε τα διαπιστευτήριά σας, περιηγηθείτε στα αιτήματα και δείτε πραγματικές απαντήσεις από το API πριν γράψετε ούτε μία γραμμή κώδικα ενσωμάτωσης. Παρακολούθηση σε όλες τις εκδόσεις — η συλλογή ενημερώνεται κάθε φορά που ενημερώνεται το API.
Τι περιλαμβάνει η συλλογή
Κάθε τελικό σημείο, με παραδείγματα φορτίων δεδομένων.
Ταξινομημένα σε φακέλους ανά πόρο. Κάθε αίτημα συνοδεύεται από ένα παράδειγμα σώματος αιτήματος, τις δύο κεφαλίδες πιστοποίησης προρυθμισμένες και μια αποθηκευμένη απάντηση-παράδειγμα — έτσι ώστε να μπορείτε να δείτε εκ των προτέρων τη μορφή της απάντησης πριν εκτελέσετε το αίτημα.
Πιστοποίηση & προϊόντα
- ΛΗΨΗ /ping — επαλήθευση διαπιστευτηρίων
- ΛΗΨΗ /products — λίστα & σελιδοποίηση (SKU + variant_id)
- Σχήματα πλήρους πεδίου στην αναφορά Swagger
Παραγγελίες
- ΑΝΑΡΤΗΣΗ /orders — δημιουργία παραγγελίας
- ΛΗΨΗ /orders/{id}/fulfillments — παρακολούθηση παραγωγής
Studio & webhooks
- ΛΗΨΗ /v2/studio/customizations/{key}/preview
- Περιεχόμενο webhook + επαλήθευση HMAC (παράδειγμα)
Εισαγωγή σε 30 δευτερόλεπτα
Αρχείο → Εισαγωγή → Σύνδεση → επικόλληση διεύθυνσης URL.
02
Ανοίξτε την καρτέλα «Μεταβλητές»
Η συλλογή διαθέτει τις δικές της μεταβλητές — base_url είναι προ-συμπληρωμένο·; access_token και application_key είναι σύμβολα κράτησης θέσης. Δεν απαιτείται ξεχωριστό αρχείο περιβάλλοντος.
03
Επικολλήστε τα κλειδιά σας
Εισάγετε το διακριτικό πρόσβασης εφαρμογής (Application Access Token) και το κλειδί εφαρμογής (Application Key) από ένα κανάλι πωλήσεων στον πίνακα ελέγχου σας, πατήστε «Αποθήκευση» και κάθε αίτημα θα πιστοποιείται.
Μεταβλητές περιβάλλοντος
Τι περιέχει το αρχείο env.
Μία βασική διεύθυνση URL, δύο διαπιστευτήρια, ενσωματωμένα στη συλλογή. Δημιουργήστε το σύστημα με βάση ένα κανάλι πωλήσεων και, στη συνέχεια, επικολλήστε τα κλειδιά του ενεργού καναλιού σας κατά την κυκλοφορία — ίδια συλλογή, ίδια αιτήματα.
Μεταβλητές συλλογής
{
"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"
}
Προκαθορισμένη πιστοποίηση
Και οι δύο κεφαλίδες πιστοποίησης, οι οποίες ορίζονται εκ των προτέρων σε κάθε αίτημα.
Κάθε αίτημα συνοδεύεται από Authorization: Bearer {{access_token}} και X-Application-Key: {{application_key}}, που αντλούνται από τις μεταβλητές της συλλογής — χωρίς να απαιτείται ρύθμιση κεφαλίδας για κάθε αίτημα. Η μετάβαση από το ένα κανάλι πωλήσεων στο άλλο γίνεται απλώς με την τροποποίηση αυτών των δύο μεταβλητών: ίδια συλλογή, διαφορετικά κλειδιά.
Παραδείγματα με λύσεις
Κάθε αίτημα συνοδεύεται από ένα δείγμα περιεχομένου και μια αποθηκευμένη απάντηση.
Η συλλογή δεν αποτελείται μόνο από σύντομους συνδέσμους URL — κάθε αίτημα συνοδεύεται από ένα παράδειγμα σώματος αιτήματος, οπότε μπορείτε να πατήσετε «Αποστολή» και να δείτε πραγματικά δεδομένα. Οι αποθηκευμένες απαντήσεις-παραδείγματα εμφανίζονται στον πίνακα «Παραδείγματα» για αναφορά εκτός σύνδεσης.
Επαλήθευση ταυτότητας
Πρώτα απ’ όλα, επαληθεύει ότι το διακριτικό πρόσβασης (Access Token) και το κλειδί εφαρμογής (Application Key) σας είναι έγκυρα. Επιστρέφει κωδικό 200 σε περίπτωση επιτυχίας και 401 αν λείπει κάποια κεφαλίδα.
Λίστα προϊόντων
Αίτημα για κατάλογο με σελιδοποίηση. Επιστρέφει τα προϊόντα σελίδα προς σελίδα στον φάκελο /meta/data, με τον κωδικό SKU και τον αναγνωριστικό παραλλαγής για κάθε προϊόν.
Δημιουργία παραγγελίας
Δείγμα περιεχομένου για παραγγελία ενός T-shirt με αρχείο PDF προέλευσης, πελάτη και διεύθυνση αποστολής. Πατήστε «Αποστολή» για να δείτε την παραγγελία που δημιουργήθηκε με τον κωδικό Fabrixa.
Παρακολούθηση παραγωγής
Ανακτά τα στάδια παραγωγής ανά τεμάχιο (εκτύπωση, σταθεροποίηση, πλύσιμο, ράψιμο) με τις καταστάσεις «σε αναμονή», «σε εξέλιξη», «ολοκληρωμένο» και «απορριφθέν» για μια παραγγελία που έχει υποβληθεί.
Προεπισκόπηση στούντιο
Επιστρέφει την εικόνα προεπισκόπησης που έχει δημιουργηθεί για μια αποθηκευμένη προσαρμογή του Studio — τοποθετήστε την απευθείας στη μικρογραφία του καλαθιού αγορών.
Έλεγχος υπογραφής
Ένα παράδειγμα υπολογισμού της υπογραφής HMAC-SHA256 και σύγκρισης της με την x-webhook-signature πριν από την επεξεργασία.
Διαχείριση εκδόσεων
Η συλλογή ενημερώνεται όταν ενημερώνεται το API.
Κάθε έκδοση του API διαθέτει μια ενημερωμένη συλλογή στην ίδια διεύθυνση URL. Επαναεισαγάγετε τη συλλογή για να λάβετε τα νέα σημεία τερματισμού και τα παραδείγματα φορτίων — τα υπάρχοντα αιτήματα στην αποθηκευμένη έκδοσή σας θα συνεχίσουν να λειτουργούν έως ότου το συγκεκριμένο σημείο τερματισμού καταργηθεί οριστικά.
Σταθερή διεύθυνση URL
Η διεύθυνση URL του JSON της συλλογής είναι μόνιμη. Κατά την εκ νέου εισαγωγή, λαμβάνεται η πιο πρόσφατη έκδοση — η διεύθυνση URL δεν αλλάζει ποτέ μεταξύ των εκδόσεων.
Αναφορά στο αρχείο αλλαγών
Δείτε το κατάλογος αλλαγών για τις αντίστοιχες σημειώσεις έκδοσης API — τι άλλαξε, τι προστέθηκε, τι καταργείται.
Πολιτική κατάργησης λειτουργιών
Τα endpoints διαθέτουν περίοδο κατάργησης διάρκειας 12 μηνών. Η συλλογή επισημαίνει τα αιτήματα που έχουν καταργηθεί στην περιγραφή, ώστε να είναι δύσκολο να παραβλεφθούν πριν προκληθεί κάποιο πρόβλημα.
Συχνές ερωτήσεις
Η συλλογή «Ο Ταχυδρόμος», απαντήσεις
Πώς μπορώ να εισαγάγω τη συλλογή Fabrixa του Postman;
Στο Postman, επιλέξτε «File» (Αρχείο), στη συνέχεια «Import» (Εισαγωγή) και μετά «Link» (Σύνδεσμος) και επικολλήστε τη διεύθυνση URL JSON της συλλογής. Το Postman προσθέτει τη συλλογή μαζί με τις μεταβλητές της στον χώρο εργασίας σας — η μεταβλητή «base_url» έχει ήδη συμπληρωθεί, ενώ οι μεταβλητές «access_token» και «application_key» είναι κενά που πρέπει να αντικαταστήσετε με το δικό σας Token Πρόσβασης Εφαρμογής και το δικό σας Κλειδί Εφαρμογής.
Ποια endpoints περιλαμβάνονται στη συλλογή Fabrixa του Postman;
Η συλλογή περιλαμβάνει το GET /ping για την επαλήθευση των διαπιστευτηρίων, το GET /products για την εμφάνιση και τη σελιδοποίηση του καταλόγου, το POST /orders για τη δημιουργία παραγγελίας, το GET /orders/{id}/fulfillments για την παρακολούθηση της παραγωγής, το σημείο τερματισμού προεπισκόπησης του Studio, καθώς και ένα λειτουργικό παράδειγμα επαλήθευσης υπογραφής webhook. Έχει δημιουργηθεί για την ένταξη v2 API και απαιτεί το Postman v10 ή νεότερη έκδοση.
Πώς ρυθμίζεται η πιστοποίηση στη συλλογή Fabrixa του Postman;
Κάθε αίτημα στη συλλογή περιλαμβάνει ήδη τις δύο απαιτούμενες κεφαλίδες — Authorization: Bearer {{access_token}} και X-Application-Key: {{application_key}} — οι οποίες αντλούνται από τις μεταβλητές της συλλογής. Η εισαγωγή του διακριτικού πρόσβασης εφαρμογής και του κλειδιού εφαρμογής σε αυτές τις μεταβλητές πιστοποιεί κάθε αίτημα ταυτόχρονα, χωρίς να απαιτείται ξεχωριστή ρύθμιση για κάθε αίτημα.
Η συλλογή «Postman» του Fabrixa ενημερώνεται όταν αλλάζει το API;
Ναι — κάθε έκδοση του API διαθέτει μια ενημερωμένη συλλογή στην ίδια μόνιμη διεύθυνση URL, οπότε η εκ νέου εισαγωγή ανακτά τα πιο πρόσφατα σημεία πρόσβασης και τα παραδείγματα δεδομένων. Τα σημεία πρόσβασης έχουν περίοδο κατάργησης 12 μηνών, ενώ η συλλογή επισημαίνει τα αιτήματα που έχουν καταργηθεί στην περιγραφή τους, προτού προκληθεί οποιοδήποτε πρόβλημα.
Τι επιστρέφει το αίτημα GET /orders/{id}/fulfillments;
Ανακτά την κατάσταση παραγωγής ανά τεμάχιο για μια παραγγελία που έχει υποβληθεί, καλύπτοντας στάδια όπως εκτύπωση, επιδιόρθωση, πλύσιμο και ράψιμο, τα οποία αναφέρονται ως «σε αναμονή», «σε εξέλιξη», «ολοκληρωμένο» ή «απορριφθέν». Η συλλογή Postman περιλαμβάνει ένα παράδειγμα εφαρμογής, ώστε να μπορεί να ελεγχθεί η μορφή της απόκρισης πριν ενσωματωθεί σε μια ενσωμάτωση.
Λήψη & έναρξη
Αποκτήστε τη συλλογή. Στείλτε το πρώτο σας αίτημα.
Εισάγετε τη συλλογή, εισάγετε τα διαπιστευτήριά σας για το κανάλι πωλήσεων και στείλτε το πρώτο σας αίτημα μέσα σε λίγα λεπτά — δεν απαιτείται κώδικας ενσωμάτωσης για να ξεκινήσετε την εξερεύνηση.