Esita tellimus, mis sisaldab ridu, allikaks olevaid PDF-faile, kliendi andmeid ja tarneaadressi. Tagastab Fabrixa tellimuse ID. Valikulised väljad saatekleebise ja jälgimisandmete jaoks.
Üks lõpppunkt. Lõputult palju tooteid.
Iga Fabrixa ja SKU, iga kangas, iga viimistlus – kättesaadav ühe dokumenteeritud REST API kaudu. Sisendiks JSON, väljundiks JSON. Webhookid iga seisundi muutuse jaoks. Iseteeninduslikud API-võtmed – loo müügikanal ja alusta arendamist.
Loodud lähtudes sellest, kuidas tootmine tegelikult toimib.
Dokumenteeritud REST API, mis peegeldab platvormi – tellimused, täitmine, Studio kohandamine ja webhookid. Sisendiks JSON, väljundiks JSON. Kasutage seda koos juhtpaneeliga või juhtige kõike programmiliselt.
Tootmise staatuse kuvamine iga tooteartikli kaupa: iga etapp (trükkimine, parandamine, pesemine, õmblemine) koos staatusetega „ootel”, „käimas”, „valmis” ja „tagasi lükatud”. Või telli webhookid, et saada teateid reaalajas.
Lülita Fabrixa Studio oma veebipoodi. Kliendid saavad tooteid reaalajas kohandada, kasutades postMessage-sündmusi ostukorvi lisamiseks ja tagasipöördumiseks ning ostukorvi pisipiltide eelvaate URL-i.
Kaks teemat: HMAC-SHA256-ga allkirjastatud andmepaketid, täielik tellimuse sisu, 10 korduskatsega edastamine koos ooteajaga.
Esita tellimus ühe POST-päringuga.
Autentitud päring, valideeritud andmepakett, koht tootmisjärjekorras reserveeritud. Kinnitus saabub millisekundite jooksul – teie kliendi tellimus on nüüd töös.
Täielik skeem, kõik lõpppunktid, veakoodid, kiiruspiirangud ja integratsiooninäited on esitatud tehnilistes dokumentides.
// 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" } }
Kaks nädalat pärast käivitub. Ilma proksita, ilma vahevara ilma.
REST-liidese otsene integreerimine teie platvormiga. Ei vaja SDK-d, proksiserverit ega kolmanda osapoole ühenduslahendust. Tavaline HTTP-ühendus teie süsteemist meie süsteemi.
Hangi rakenduse juurdepääsutoken ja rakendusvõti, luues oma juhtpaneelis müügikanali. Mõlemad on vajalikud iga päringu puhul: Bearer-token autoriseerimisel, rakendusvõti väljas X-Application-Key.
Sirvige Swaggeri reaalajas viidet, et leida müüdavate toodete variandid SKUs, samuti filtreerimis- ja lehekülgede jaotamise mustrid.
Kassasse minnes saada POST-päring, mis sisaldab ridu, allikaid (PDF-i URL-aadresse), kliendi andmeid ja saatmisadresse. Salvesta tagastatud Fabrixa tellimuse ID oma tellimuse viitenumbri juurde.
Ava avalik POST-lõpppunkt. Me allkirjastame iga andmepaketi HMAC-SHA256-ga (x-webhook-signature), et saaksid enne töötlemist selle autentsust kontrollida.
Vabatahtlik: lisage Fabrixa Studio iframe oma tootelehele. Kliendid saavad toodet kohandada reaalajas; nende kohandused lisatakse tellimusele POST-päringu abil.
Kõik, mida teie insenerimeeskond vajab.
Täielik API viide
Täielikud lõpppunktide dokumendid, päringu- ja vastusskeemid, veakoodid, kiiruspiirangud, autentimine, Studio integreerimine ja webhook-lepingud – koos reaalajas töötava Swaggeri liidesega.
Ava dokumendid →Loo müügikanali jaoks
Loo spetsiaalne müügikanal, mille põhjal edasi arendada – esita testtellimusi, kontrolli webhooki toimimist, valideeri erandjuhtumeid – ning suuna seejärel tegelik liiklus oma tootmiskeskkonnas olevale kanalile. Teie võtmed on valmis kohe, kui olete kanali loonud – eraldi taotlemist ei ole vaja.
Loo oma konto →Postiljoni kogumik
Eelkonfigureeritud päringute kogum, mis sisaldab näidispakette ja autentimist. Impordi see oma testimisprotsessi.
Hangi kollektsioon →Kahe pealkirjaga autentimine. Allkirjastatud veebihookid. Kiiruspiirang.
Tavapärased toimingud, üllatusi ei ole. Iga päring autentifitseeritakse nii Bearer-tokeniga kui ka rakendusvõtmega. Iga webhook on kontrollimiseks HMAC-allkirjastatud ning rakenduspõhised kasutamispiirangud on ettearvatavad.
Rakenduse juurdepääsutoken
Autoriseerimise päises olev kandja-token. Identifitseerib kutsuvat rakendust.
Rakenduse võti
Saadetakse X-Application-Key-päises. Mõlemad on iga päringu puhul kohustuslikud – kui üks neist puudub, antakse vastuseks 401.
TLS-krüpteerimine
Aadressil api.fabrixa.com kasutatakse ainult HTTPS-i. Lihttekstina esitatud päringud lükatakse servas tagasi.
Webhooki allkirjad
Iga webhook on allkirjastatud HMAC-SHA256-ga, mis edastatakse x-webhook-signature-pealkirjas. Kontrolli seda enne töötlemist.
Kiiruspiirangud
30 päringut rakenduse kohta minutis. Iga vastusega edastatakse parameetrid „X-RateLimit-Limit“ ja „X-RateLimit-Remaining“.
Webhooki korduskatseid
Kuni 10 kättetoimetamiskatseid, kui vastus ei ole 2xx- või 3xx-koodiga. Veebihook lülitatakse välja pärast 10. ebaõnnestumist.
Integreerimine API, vastus
Kuidas saan end Fabrixa ja API süsteemides autentida?
Iga päring peab sisaldama kahte päist: rakenduse juurdepääsutokeni, mis saadetakse „Bearer“-tokenina päises „Authorization“, ning rakenduse võtit päises „X-Application-Key“. Mõlemad genereeritakse kohe, kui loote müügikanali Fabrixa-i juhtpaneelis, ning kui mõni neist päistest puudub, lükatakse päring tagasi veakoodiga 401.
Kas ma saan Fabrixa ja API enne tegelike tellimuste saatmist proovida?
Jah – looge spetsiaalne müügikanal, mille põhjal edasi arendada, esitage testtellimusi, kontrollige webhooki toimimist ja testige erandjuhtumeid; kui kanal töötab, suunake seejärel tegelik liiklus oma tootmiskeskkonnas asuvale kanalile. Selle kanali registreerimisel ja loomisel muutuvad teie rakenduse juurdepääsutoken ja rakenduse võti kohe kättesaadavaks, ilma et oleks vaja esitada eraldi taotlust.
Kas Fabrixa-integratsioon API on HTTPS-iga krüpteeritud?
Jah — API toetab veebisaidil api.fabrixa.com ainult HTTPS-i ning kõik tavatekstina esitatud päringud lükatakse servas tagasi. Iga päring autentitakse nii Bearer-tokeniga kui ka rakendusvõtmega ning iga webhooki andmepakett on allkirjastatud HMAC-SHA256-ga, et seda saaks enne töötlemist kontrollida.
Mida annab POST-päring aadressile /v2/integration/orders tagasi?
Autentifitseeritud POST-päring aadressile /v2/integration/orders valideerib andmepaketi, reserveerib koha tootmisjärjekorras ja tagastab millisekundites kinnituse koos Fabrixa tellimuse ID-ga, millele võivad lisanduda valikulised saatmisetiketi ja jälgimisandmed. Tellimuse täitmist saab seejärel jälgida iga üksiku kirje kaupa või see edastatakse teile veebihookide kaudu.
Kas Fabrixa ja API integreerimiseks on vaja SDK-d või proksit?
Ei — fabrixa integratsioon toimub otsese REST-ühenduse kaudu standardse HTTP-protokolli abil, ilma et oleks vaja SDK-d, proksiserverit ega kolmanda osapoole ühenduslahendust. Saate fabrixa-ga ühendust luua otse oma süsteemist, kasutades JSON-päringuid ja -vastuseid ning webhooke seisundi muutuste jaoks.
Loo müügikanal ja alusta selle arendamist juba täna.
Registreeruge, looge müügikanal ja teie API kasutajatunnused on kohe valmis. Vajate abi? Meie lahenduste insenerid vastavad 24 tunni jooksul – enamik meeskondi on kasutusvalmis kahe nädala jooksul.


