Ir divi veidi, kā nosūtīt pasūtījumus uz Fabrixa: savienot jau esošo veikalu — Shopify vai WooCommerce — bez programmēšanas, vai izveidot to tieši, izmantojot API integrāciju. Šajā rokasgrāmatā ir aprakstīti abi veidi: kā savienot pārdošanas kanālu dažu minūšu laikā vai kā no autorizācijas līdz pasūtījuma izpildei nonākt piecpadsmit minūtēs.
Lielākā daļa veikalu nekad neizmanto API. Pievienojiet Fabrixa kā pārdošanas kanālu, un pasūtījumi no jūsu veikala nonāk tieši ražošanā — produkti tiek sinhronizēti, statusi tiek atjaunināti, nav nepieciešams rakstīt vai uzturēt kodu. Tālāk aprakstītais API maršruts ir paredzēts pielāgotām veikalu saskarnēm un POD platformām.
Atveriet savu vadības paneli Create channel un izvēlieties integrācijas veidu. Katram kanālam ir savi produkti, importētie pasūtījumi un importēšanas noteikumi — savienojiet tik daudz kanālu, cik vien izmantojat.
Nav nepieciešams kopēt atslēgas. Autorizējiet Fabrixa savā Shopify administrācijas panelī, un savienojums tiks izveidots.
Create channel, izvēlieties Shopify.WordPress veikals savienojas, izmantojot lasīšanas/rakstīšanas REST atslēgu pāri — tas tiek ģenerēts WooCommerce un vienreiz ievietots Fabrixa.
Settings → Advanced → REST API → Add key ar Lasīšana/rakstīšana atļaujas.ck_ atslēga, cs_ paroli un jūsu veikala domēnu vietnē Fabrixa.Pārdodat individualizētus produktus? Fabrixa Studio — „white-label“ dizaina redaktors — ir pieejams arī Shopify un WooCommerce veikalos, tādējādi jūsu pircēji var personalizēt produktus ar jūsu zīmolu. Skatīt Fabrixa Studio →
Sadaļā „Kanāli” savienotie veikali atrodas blakus jūsu API un partneru kanāliem — sinhronizētie produkti, saņemtie pasūtījumi, pēdējā importētā atsauce un ieņēmumi pa kanāliem. Kad esat gatavs, pārslēdziet kanālu no „uzmetuma” uz „aktīvo” režīmu; nekas tālākajā procesā nemainās.
Vai drīzāk vēlaties izveidot pielāgotu veikala saskarni vai savu POD platformu? Šīs rokasgrāmatas turpmākajā daļā tiks aprakstīts API ceļš — no autentifikācijas līdz pasūtījuma izpildei četros soļos.
Lai no nulles nonāktu līdz aktīvam pasūtījumam, ir nepieciešamas trīs lietas. Visas tās var izsniegt no jūsu Fabrixa vadības paneļa vai jūsu risinājumu inženieris.
Lietojumprogrammas piekļuves žetons un lietojumprogrammas atslēga. Abi ir nepieciešami katrā pieprasījumā — žetons „Authorization“ galvenē, bet atslēga — „X-Application-Key“ galvenē. Izveidojiet pārdošanas kanālu savā vadības panelī, lai tos ģenerētu uzreiz — pieprasījums nav nepieciešams.
Publiski pieejams HTTPS galapunkts, kas pieņem JSON POST pieprasījumus. Izstrādes laikā „localhost“ darbojas, izmantojot tuneli. Pirms apstrādes jūs pārbaudāt HMAC-SHA256 parakstu katrā datu blokā.
Jūsu grafiskā faila — PDF, TIFF, JPG vai PNG — piekļuve ir iespējama caur HTTPS bez autentifikācijas. RGB krāsu režīms, līdz 50 MB un 15 000 pikseļu uz katru pusi. Daudzlapu PDF failos katra lapa atrodas atsevišķā slānī. Mēs lejupielādējam failu un izveidojam pareizos drukas failus, kad veicam pasūtījuma apstrādi.
Katrs pieprasījums tiek nosūtīts uz bāzes URL https://api.fabrixa.com/v2/integration ja abi galvenes ir iestatīti. GET /ping pirms jebkādas turpmākas darbības pārbauda, vai žetons un atslēga ir derīgi.
Stāvoklis 401 nozīmē, ka trūkst galvenes vai ka žetons ir atsaukts. Stāvoklis 403 nozīmē, ka autentifikācijas dati ir derīgi, taču trūkst atļaujas piekļūt resursam.
# Verify auth before anything else curl https://api.fabrixa.com/v2/integration/ping \ -H "Accept: application/json" \ -H "Authorization: Bearer APPLICATION_ACCESS_TOKEN" \ -H "X-Application-Key: APPLICATION_KEY" # 200 OK → credentials valid # 401 → missing header or revoked token # 403 → valid, but no access to the resource
Katalogs atgriež produktu variantus ar to SKU un variant_id. Katra saraksta atbilde ir ietverta standarta links / meta / data aploksne, tāpēc lappuses numurējiet ar next_page saite. Saglabā vietējā kešatmiņā — katalogs netiek ģenerēts katram pieprasījumam atsevišķi.
Pilnīga informācija par lauku ir atrodama Swagger atsauce.
GET /v2/integration/products?page=1
{
"links": {
"self": ".../products?page=1",
"next_page": ".../products?page=2",
"prev_page": null
},
"meta": { "total": 248, "current_page": 1, "per_page": 10 },
"data": [
{ "id": 1306, "name": "Unisex AOP T-shirt", "SKU": "COF099191" }
]
}
Nosūtīt rows (SKU + daudzums + PDF avots), customer un shipping_address. Iestatiet savu number kā atsauci — ja to neiekļauj, mēs to ģenerēsim. Saglabājiet atgriezto Fabrixa pasūtījuma identifikatoru saistībā ar jūsu pasūtījumu.
Studijas pasūtījumi aizstāj sources fails ar cart_item_key no saglabātā dizaina; viss pārējais ir identisks.
POST /v2/integration/orders
{
"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"
}
}
Iestatiet savu webhook URL adresi vadības panelī. Mēs veicam POST pieprasījumu order.created un order.updated pievienot tam pilnu pasūtījuma tekstu, kā arī x-webhook-signature (HMAC-SHA256) un x-webhook-topic galvene. Pārbaudiet parakstu, atgriezieties 200 ātri, apstrādāt asinhroni.
Visi notikumi un pārbaudes fragmenti atrodas webhooks rokasgrāmata.
# Request headers content-type: application/json x-webhook-topic: order.updated x-webhook-signature: YmEwNjBhMGMy...AxMw== # Body (truncated) { "id": 23069, "number": "1250211835", "status": "imported", "fulfillment_status": "unfulfilled", "updated_at": "2026-05-28T07:43:52Z" }
Kļūdas tiek atgrieztas JSON formātā, nekad HTML. Šī errors.messages masīvs norāda, kas neizdevās; ja tiek atgriezts 400 kļūdas kods, tajā tiek uzskaitīti lauki, kuru validācija neizdevās.
Pārbaudes kļūda, trūkstošas vai atsauktas piekļuves tiesības, nepietiekamas atļaujas vai nezināms resurss.
30 pieprasījumi uz vienu lietojumprogrammu minūtē. X-RateLimit-Limit un X-RateLimit-Remaining ir katrā atbildē.
Servera pusē. Mēģiniet vēlreiz, ievērojot atkāpšanās intervālu; ja problēma saglabājas, nosūtiet pieprasījuma identifikatoru savam risinājumu inženierim.
{
"links": { "self": ".../v2/integration/orders" },
"meta": [],
"errors": {
"messages": [
"Application Key is not specified."
]
}
}
Fabrixa atļauj 30 pieprasījumus minūtē katrai lietojumprogrammai; ja šis limits tiek pārsniegts, tiek atgriezta atbilde „429 Too Many Requests“. Katrai atbildei tiek pievienoti galvenes „X-RateLimit-Limit“ un „X-RateLimit-Remaining“, lai integrācija varētu sekot līdzi atlikušajai kvotai, pirms tiek sasniegts limits.
Fabrixa pieņem PDF, TIFF, JPG vai PNG formāta grafiskos failus RGB krāsu režīmā, kuru izmērs nepārsniedz 50 MB un 15 000 pikseļu uz vienu pusi, un kuri ir pieejami caur HTTPS bez autentifikācijas. Daudzlapu PDF faili tiek uzskatīti par vienu lapu katrā slānī, un Fabrixa pats lejupielādē failu, lai izveidotu pareizos drukas failus, kad tiek renderēts uzdevums.
WooCommerce atveriet sadaļu „Iestatījumi”, pēc tam „Papildu”, tad „REST API” un pievienojiet atslēgu ar lasīšanas/rakstīšanas tiesībām. Ielīmējiet iegūto ck_ atslēgu, cs_ slepeno kodu un jūsu veikala domēnu laukā „Fabrixa”, saglabājiet, un pasūtījumi tiks sinhronizēti automātiski — importēšanas noteikumus vēlāk var mainīt kanāla iestatījumos.
Pirms pirmā pasūtījuma veikšanas jums ir nepieciešams lietojumprogrammas piekļuves žetons un lietojumprogrammas atslēga no pārdošanas kanāla, publisks HTTPS webhook galapunkts, kas pārbauda HMAC-SHA256 parakstu katrā datu blokā, kā arī attēli, kas ir pieejami caur HTTPS bez autentifikācijas. Visi trīs tiek izsniegti vai konfigurēti no Fabrixa vadības paneļa, un autentifikācijas dati tiek ģenerēti uzreiz pēc pārdošanas kanāla izveides.
Kļūda 403 nozīmē, ka lietojumprogrammas piekļuves žetons un lietojumprogrammas atslēga ir derīgi, taču trūkst atļaujas pieprasītajam resursam. Tas atšķiras no kļūdas 401, kas nozīmē, ka trūkst nepieciešamā galvenes informācija vai žetons ir atsaukts; abas situācijas var pārbaudīt, izmantojot GET /ping pieprasījumu, pirms turpināt darbu.
Ja nepieciešams atbalsts integrācijas jautājumos, jautājumos par piekļuves datiem vai pārdošanas kanāliem, individuālām prasībām vai jaudas plānošanai — sazinieties ar tehnisko SE kanālu, nevis pārdošanas nodaļu. Atbilde tiks sniegta vienas darba dienas laikā.
Jūs varat izveidot savienojumu, izmantojot mūsu REST API un produktu datu plūsmu, savukārt mūsu dizaina redaktoru Fabrixa Studio var iebūvēt jūsu pašu platformā, lai tas izskatītos kā jūsu pašu funkcija.
Lasīt atbildi →Pašlaik tas atrodas izstrādes stadijā; mūsu komanda strādā pie pasūtījumu automātiskas iesniegšanas, produktu, cenu un krājumu sinhronizācijas, kā arī atgriezumpreču automātiskas izsekošanas.
Lasīt atbildi →Resursi izstrādātājiem: API dokumentācija https://www.fabrixa.com/developers/api-documentation · Integrācijas rokasgrāmata https://www.fabrixa.com/developers/integration-guide/ · Webhooki https://api.fabrixa.com/docs/integration#webhooks
Lasīt atbildi →Visas 8 atbildes par integrācijām un API → Jautājiet mūsu atbalsta komandai →
