Iesniedziet pasūtījumu, norādot rindas, avota PDF failus, klienta datus un piegādes adresi. Atgriež Fabrixa pasūtījuma identifikatoru. Piegādes etiķetes un sūtījuma izsekošanas lauki ir fakultatīvi.
Viens galapunkts. Bezgalīgi daudz produktu.
Katrs Fabrixa un SKU, katrs audums, katrs apdares veids — pieejams, izmantojot vienu dokumentētu REST API. Ievade un izvade JSON formātā. Webhooki katrai stāvokļa maiņai. Pašapkalpošanās API atslēgas — izveidojiet pārdošanas kanālu un sāciet izstrādi.
Izstrādāts, ņemot vērā ražošanas reālo darbību.
Dokumentēta REST API saskarne, kas atspoguļo platformas funkcionalitāti — pasūtījumus, izpildi, „Studio“ pielāgošanu un webhookus. Ievade un izvade JSON formātā. Izmantojiet to kopā ar vadības paneli vai vadiet visu programmatiski.
Iegūstiet ražošanas statusu par katru pozīciju: katrs posms (drukāšana, labošana, mazgāšana, šūšana) ar statusiem „gaida apstiprinājumu”, „procesā”, „pabeigts” vai „noraidīts”. Vai arī abonējiet webhookus, lai saņemtu paziņojumus.
Ievietojiet Fabrixa Studio savā veikala sākumlapā. Klienti var pielāgot produktus reāllaikā, izmantojot „postMessage“ notikumus, lai pievienotu preces grozam vai atgrieztos atpakaļ, kā arī priekšskatīšanas URL saiti groza sīktēliem.
Divas tēmas: ar HMAC-SHA256 parakstīti datu bloki, pilna pasūtījuma saturs, piegāde ar 10 atkārtotiem mēģinājumiem un atkāpšanās mehānismu.
Veiciet pasūtījumu vienā POST.
Autentificēts pieprasījums, pārbaudīta datu daļa, vieta rezervēta ražošanas rindā. Apstiprinājums saņemts milisekundēs — jūsu klienta pasūtījums tagad ir apstrādē.
Pilnīga shēma, visi galapunkti, kļūdu kodi, pieprasījumu ierobežojumi un integrācijas piemēri ir atrodami tehniskajā dokumentācijā.
// POST https://api.fabrixa.com/v2/integration/orders // Authorization: Bearer APPLICATION_ACCESS_TOKEN // X-Application-Key: APPLICATION_KEY { "number": "ORD-2026-0142", "purchased_at": "2026-05-28 14:22:01", "rows": [ { "sku": "COF099191", "quantity": 1, "sources": [ { "type": "file", "url": "https://cdn.you.com/art/9812.pdf" } ] } ], "customer": { "first_name": "Maria", "last_name": "Silva", "email": "maria@example.com", "phone": "+351912345678" }, "shipping_address": { "address": "Rua do Carmo 42", "city": "Lisboa", "postal_code": "1200-094", "country_code": "PT", "country": "Portugal" } }
Pieejams pēc divām nedēļām. Bez starpniekservera, bez starpprogrammatūras.
Tieša REST integrācija jūsu platformā. Nav nepieciešams SDK, nav nepieciešams starpniekserveris, nav nepieciešams trešās puses savienotājs. Standarta HTTP no jūsu sistēmas uz mūsu sistēmu.
Iegūstiet lietojumprogrammas piekļuves žetonu un lietojumprogrammas atslēgu, izveidojot pārdošanas kanālu savā vadības panelī. Abi ir nepieciešami katrā pieprasījumā: „Bearer“ žetons autorizācijas posmā, lietojumprogrammas atslēga — laukā „X-Application-Key“.
Pārlūkojiet interaktīvo Swagger atsauci, lai atrastu variantu SKUs produktiem, kurus vēlaties pārdot, kā arī filtrēšanas un lappušu numerācijas paraugus.
Veicot norēķinu, nosūtiet POST pieprasījumu, iekļaujot rindas, avotus (PDF URL), klientu un piegādes adresi. Saglabājiet saņemto Fabrixa pasūtījuma identifikatoru, saistot to ar savu pasūtījuma atsauces numuru.
Izveidojiet publisku POST galapunktu. Mēs katru datu slodzi parakstām ar HMAC-SHA256 (x-webhook-signature), lai jūs varētu pārbaudīt tās autentiskumu pirms apstrādes.
Pēc izvēles: ievietojiet Fabrixa Studio iframe savā produktu lapā. Klienti veic personalizāciju reāllaikā; savas pielāgojumu izmaiņas pievieno pasūtījumam, izmantojot POST pieprasījumu.
Viss, kas nepieciešams jūsu inženieru komandai.
Pilnīga API atsauce
Pilnīga galapunktu dokumentācija, pieprasījumu/atbilžu shēmas, kļūdu kodi, pieprasījumu ierobežojumi, autentifikācija, Studio integrācija un webhook līgumi — ar reāllaika Swagger saskarni.
Atvērt dokumentus →Izstrādāt, ņemot vērā pārdošanas kanālu
Izveidojiet speciālu pārdošanas kanālu, uz kura pamata veikt izstrādi — iesniedziet testa pasūtījumus, pārbaudiet webhook piegādi, pārbaudiet robežgadījumus — un pēc tam novirziet reālo apmeklētāju plūsmu uz jūsu aktīvo kanālu. Jūsu atslēgas ir gatavas jau brīdī, kad izveidojat kanālu — nav nepieciešams veikt atsevišķu pieprasījumu.
Izveidojiet savu kontu →„Postman“ kolekcija
Iepriekš konfigurēta pieprasījumu kolekcija ar paraugiem datu blokiem un autentifikāciju. Importējiet to savā testēšanas darba plūsmā.
Iegūstiet kolekciju →Autentifikācija ar diviem galvenes laukiem. Parakstīti webhooki. Pārraides ātruma ierobežojums.
Standarta prakse, bez pārsteigumiem. Katrs pieprasījums tiek autentificēts, izmantojot gan „Bearer“ žetonu, gan lietojumprogrammas atslēgu. Katrs webhook ir parakstīts ar HMAC, lai nodrošinātu pārbaudi, un tam ir paredzami, katrai lietojumprogrammai atsevišķi noteikti apjoma ierobežojumi.
Lietojumprogrammas piekļuves žetons
„Bearer“ tokens autorizācijas galvenē. Identificē izsaucēju lietojumprogrammu.
Lietojumprogrammas atslēga
Tiek nosūtīts X-Application-Key galvenē. Abi ir obligāti katrā pieprasījumā — ja kāds no tiem trūkst, tiek atgriezts 401.
TLS šifrēšana
Vietnē api.fabrixa.com tiek izmantots tikai HTTPS. Pieprasījumi nešifrētā tekstā tiek noraidīti piekļuves punktā.
Webhook paraksti
Katrs webhook ir parakstīts ar HMAC-SHA256, kas tiek nosūtīts x-webhook-signature galvenē. Pirms apstrādes pārbaudiet to.
Lietojuma ierobežojumi
30 pieprasījumi minūtē katrai lietojumprogrammai. Katru reizi atbildē tiek atgriezti parametri „X-RateLimit-Limit“ un „X-RateLimit-Remaining“.
Webhook atkārtotie mēģinājumi
Līdz 10 piegādes mēģinājumiem, ja atbilde nav 2xx vai 3xx. Pēc 10. neveiksmes webhook tiek deaktivizēts.
Atbilde uz jautājumu par integrāciju API
Kā veikt autentifikāciju, izmantojot Fabrixa un API?
Katram pieprasījumam ir nepieciešami divi galvenes lauki: lietojumprogrammas piekļuves žetons, kas tiek nosūtīts kā „Bearer“ žetons galvenē „Authorization“, un lietojumprogrammas atslēga galvenē „X-Application-Key“. Abi tiek ģenerēti brīdī, kad izveidojat pārdošanas kanālu Fabrixa vadības panelī, un pieprasījums tiek noraidīts ar kļūdas kodu 401, ja kāds no šiem galvenes laukiem trūkst.
Vai es varu izmēģināt Fabrixa un API, pirms nosūtu reālus pasūtījumus?
Jā — izveidojiet īpašu pārdošanas kanālu, uz kura pamata veikt attīstību, iesniedziet testa pasūtījumus, pārbaudiet webhook piegādi un apstipriniet robežgadījumus, un tad, kad kanāls darbosies, novirziet reālo datplūsmu uz savu aktīvo kanālu. Reģistrējoties un izveidojot šo kanālu, jūsu lietojumprogrammas piekļuves žetons un lietojumprogrammas atslēga kļūst pieejami uzreiz, bez atsevišķa pieprasījuma soļa.
Vai Fabrixa integrācija API ir šifrēta ar HTTPS?
Jā — API vietnē api.fabrixa.com darbojas tikai ar HTTPS, un jebkurš pieprasījums nešifrētā tekstā tiek noraidīts jau pie ieejas. Katrs pieprasījums tiek autentificēts gan ar „Bearer“ žetonu, gan ar lietojumprogrammas atslēgu, un katrs webhook datu bloks tiek parakstīts ar HMAC-SHA256, lai to varētu pārbaudīt pirms apstrādes.
Ko atgriež POST pieprasījums uz /v2/integration/orders?
Autentificēts POST pieprasījums uz /v2/integration/orders pārbauda datu saturu, rezervē vietu ražošanas rindā un atgriež apstiprinājumu ar Fabrixa pasūtījuma identifikatoru milisekundēs, kā arī papildu laukus par sūtījuma etiķeti un izsekošanu. Pēc tam pasūtījuma izpildi var izsekot pa atsevišķām pozīcijām vai saņemt paziņojumus par to, izmantojot webhookus.
Vai man ir nepieciešams SDK vai starpniekserveris, lai veiktu integrāciju ar Fabrixa un API?
Nē — fabrixa integrācija ir tiešs REST savienojums, izmantojot standarta HTTP protokolu, kam nav nepieciešams ne SDK, ne starpniekserveris, ne arī trešās puses savienotājs. Jūs izsaucat fabrixa tieši no savas sistēmas, izmantojot JSON pieprasījumus un atbildes, kā arī webhookus stāvokļa izmaiņu gadījumos.
Izveidojiet pārdošanas kanālu un sāciet tā izveidi jau šodien.
Reģistrējieties, izveidojiet pārdošanas kanālu, un jūsu API piekļuves dati būs pieejami uzreiz. Vajadzīga palīdzība? Mūsu risinājumu inženieri atbildēs 24 stundu laikā — lielākā daļa komandu sāk darbu divu nedēļu laikā.


