01
Importă colecția
În Postman: File → Import → Link. Lipiți adresa URL JSON din butonul de descărcare de mai sus. Postman adaugă colecția — împreună cu variabilele sale — în spațiul dvs. de lucru.
Dezvoltatori · Colecția Postman
Importă colecția. Atinge API în cinci minute.
O colecție Postman preconfigurată, cu exemple concrete pentru integrarea Fabrixa cu API. Introduceți datele de autentificare, parcurgeți cererile și vedeți răspunsuri reale din partea API înainte de a scrie vreo linie de cod de integrare. Actualizată în funcție de versiuni — colecția se actualizează odată cu API.
Ce conține colecția
Fiecare punct final, cu exemple de date utile.
Organizate în dosare în funcție de resursă. Fiecare solicitare include un exemplu de corp al solicitării, cele două antete de autentificare prestabilite și un exemplu de răspuns salvat — astfel încât să puteți previzualiza forma răspunsului înainte de a trimite solicitarea.
Autentificare și produse
- OBȚINE /ping — verifică datele de autentificare
- OBȚINE /produse — listare și paginare (SKU + variant_id)
- Scheme complete în documentația de referință Swagger
Comenzi
- POSTARE /comenzi — creează o comandă
- OBȚINE /orders/{id}/fulfillments — urmărirea procesului de producție
Studio și webhooks
- OBȚINE /v2/studio/personalizări/{cheie}/previzualizare
- Conținutul webhook-ului + verificarea HMAC (exemplu)
Import în 30 de secunde
Fișier → Import → Legătură → lipiți adresa URL.
02
Deschideți fila „Variabile”
Colecția vine cu propriile variabile — base_url este completat în prealabil; access_token și application_key sunt caractere de substituție. Nu este necesar un fișier de mediu separat.
03
Lipiți cheile
Introduceți tokenul de acces al aplicației și cheia aplicației dintr-un canal de vânzări în tabloul de bord, apăsați pe „Salvare”, iar fiecare solicitare va fi autentificată.
Variabile de mediu
Ce conține fișierul env.
O singură adresă URL de bază, două seturi de date de autentificare, integrate în colecție. Configurează sistemul pentru un singur canal de vânzări, apoi introdu cheile canalului dumneavoastră activ în momentul lansării — aceeași colecție, aceleași solicitări.
Variabile de colectare
{
"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"
}
Autentificare preconfigurată
Ambele antete de autentificare, prestabilite pentru fiecare cerere.
Fiecare cerere implică Authorization: Bearer {{access_token}} și X-Application-Key: {{application_key}}, preluate din variabilele colecției — fără configurarea antetului pentru fiecare cerere în parte. Trecerea de la un canal de vânzări la altul se face pur și simplu prin modificarea celor două variabile: aceeași colecție, chei diferite.
Exemple rezolvate
Fiecare solicitare include un conținut de exemplu și un răspuns salvat.
Colecția nu conține doar adrese URL incomplete — fiecare cerere are un corp de exemplu complet, astfel încât puteți apăsa butonul „Trimite” și puteți vedea date reale. Răspunsurile de exemplu salvate se află în panoul „Exemple” pentru consultare offline.
Verifică autentificarea
Verifică mai întâi dacă tokenul de acces al aplicației și cheia aplicației sunt valide. Returnează codul 200 în caz de succes și 401 dacă lipsește un antet.
Afișează produsele
Solicitare de catalog paginat. Returnează produsele pagină cu pagină în pachetul de date / meta / linkuri, împreună cu codul SKU și ID-ul variantei pentru fiecare articol.
Creează o comandă
Exemplu de conținut pentru o comandă de un tricou, cu un fișier PDF sursă, datele clientului și adresa de livrare. Apăsați butonul „Trimite” pentru a vizualiza comanda creată, împreună cu ID-ul acesteia, Fabrixa.
Urmărirea producției
Afișează etapele de producție pentru fiecare articol (imprimare, fixare, spălare, cusut) cu stările „în așteptare”, „în curs”, „finalizat” și „respins” pentru o comandă plasată.
Prezentare preliminară a studioului
Returnează imaginea de previzualizare generată pentru o personalizare Studio salvată — o puteți insera direct ca miniatură în coșul de cumpărături.
Verificarea semnăturii
Un exemplu concret de recalculare a semnăturii HMAC-SHA256 și de comparare a acesteia cu x-webhook-signature înainte de procesare.
Versiuni
Colecția se actualizează odată cu actualizarea API.
Fiecare versiune API include o colecție actualizată la aceeași adresă URL. Reimportați pentru a prelua noile puncte de acces și încărcăturile de exemplu — cererile existente din versiunea dvs. salvată vor continua să funcționeze până când respectivul punct de acces va fi efectiv învechit.
URL stabil
URL-ul fișierului JSON al colecției este permanent. La reimportare se preia cea mai recentă versiune — URL-ul nu se modifică niciodată între versiuni.
Referință privind istoricul modificărilor
Vezi jurnal de modificări pentru notele corespunzătoare versiunii API — ce s-a modificat, ce s-a adăugat, ce este în curs de eliminare.
Politica privind elementele învechite
Punctele de capăt beneficiază de o perioadă de 12 luni de învechire. Colecția semnalează cererile învechite în descriere, astfel încât acestea să fie greu de trecut cu vederea înainte ca ceva să nu mai funcționeze.
Întrebări frecvente
Colecția „Poștașul”, răspunsuri
Cum pot importa colecția Fabrixa din Postman?
În Postman, selectează „File”, apoi „Import”, apoi „Link” și lipește adresa URL JSON a colecției. Postman adaugă colecția împreună cu variabilele sale în spațiul dumneavoastră de lucru — „base_url” este completat automat, în timp ce „access_token” și „application_key” sunt locuri de rezervă pe care le înlocuiești cu propriul dumneavoastră token de acces la aplicație și cu propria ta cheie de aplicație.
Ce puncte finale sunt incluse în colecția Postman Fabrixa?
Colecția include GET /ping pentru verificarea datelor de autentificare, GET /products pentru afișarea și paginarea catalogului, POST /orders pentru crearea unei comenzi, GET /orders/{id}/fulfillments pentru urmărirea procesului de producție, punctul final de previzualizare Studio și un exemplu concret de verificare a semnăturii unui webhook. Aceasta este concepută pentru v2 Integration API și necesită Postman v10 sau o versiune ulterioară.
Cum se configurează autentificarea în colecția Fabrixa pentru Postman?
Fiecare cerere din colecție conține deja cele două antete obligatorii — Authorization: Bearer {{access_token}} și X-Application-Key: {{application_key}} — preluate din variabilele colecției. Introducerea tokenului de acces al aplicației și a cheii aplicației în aceste variabile autentifică toate cererile simultan, fără a fi necesară configurarea pentru fiecare cerere în parte.
Colecția „Postman” din Fabrixa se actualizează atunci când se modifică API?
Da — fiecare versiune API include o colecție actualizată la aceeași adresă URL permanentă, astfel încât reimportarea preia cele mai recente puncte de acces și exemple de date de încărcare. Punctele de acces beneficiază de o perioadă de 12 luni de învechire, iar colecția semnalează cererile învechite în descrierea lor înainte ca ceva să nu mai funcționeze.
Ce returnează solicitarea GET /orders/{id}/fulfillments?
Aceasta preia starea de producție pentru fiecare articol dintr-o comandă plasată, acoperind etape precum tipărirea, fixarea, spălarea și cusutul, fiecare fiind raportată ca fiind în așteptare, în curs de desfășurare, finalizată sau respinsă. Colecția Postman include un exemplu concret, astfel încât structura răspunsului să poată fi verificată înainte de a fi integrată într-un proces de integrare.
Descărcați și începeți
Descărcați colecția. Trimiteți prima solicitare.
Importați colecția, introduceți datele de autentificare pentru canalul de vânzări și trimiteți prima solicitare în doar câteva minute — nu este nevoie de cod de integrare pentru a începe explorarea.