Fabrixa-le tellimuste saatmiseks on kaks võimalust: ühendage oma olemasolev pood – Shopify või WooCommerce – ilma programmeerimiseta või looge see otse API-integratsiooni kaudu. Käesolev juhend käsitleb mõlemat võimalust: müügikanali ühendamine võtab vaid mõne minuti, autoriseerimisest tellimuse täitmiseni kulub viisteist minutit.
Enamik poode ei kasuta API-lahendust üldse. Lisage Fabrixa müügikanalina ja teie poe tellimused suunatakse otse tootmisse – tooted sünkroniseeritakse, staatused edastatakse tagasi, koodi pole vaja kirjutada ega hooldada. Allpool kirjeldatud API-marsruut on mõeldud kohandatud veebipoodidele ja POD-platvormidele.
Ava oma juhtpaneelis Create channel ja vali integratsiooni tüüp. Igal kanalil on oma tooted, imporditud tellimused ja impordireeglid – ühenda nii palju kanaleid, kui sul on kasutusel.
Võtmeid pole vaja kopeerida. Autoriseeri Fabrixa oma Shopify halduskeskkonnas ja ühendus on kohe kasutusel.
Create channel, vali Shopify.WordPressi pood ühendub lugemis- ja kirjutusõigustega REST-võtmepaariga, mis genereeritakse WooCommerce’is ja kleebitakse ühekordselt Fabrixa-sse.
Settings → Advanced → REST API → Add key koos Lugemine/kirjutamine õigused.ck_ võti, cs_ sisesta salasõna ja oma poe domeen Fabrixa-sse.Kas müüd kohandatud tooteid? Fabrixa Studio — valge sildi kujundusredaktor — on saadaval ka Shopify ja WooCommerce’i poodides, nii et teie ostjad saavad tooteid teie brändi all isikupärastada. Vaata Fabrixa Studio →
Vaates „Kanalid“ asuvad ühendatud poed teie API ja partnerkanalite kõrval – sünkroniseeritud tooted, saadud tellimused, viimati imporditud viitenumber ja käive kanali kohta. Kui olete valmis, saate kanali eelnõust avalikku režiimi viia; allpool asuvates protsessides ei muutu midagi.
Kas loote pigem kohandatud veebipoe või hoopis oma POD-platvormi? Käesoleva juhendi ülejäänud osa käsitleb API-lahendust – neljas etapis alates autentimisest kuni tellimuse täitmiseni.
Kolm asja aitavad sul jõuda nullist reaalse tellimuseni. Kõik need väljastatakse Teie Fabrixa juhtpaneeli kaudu või Teie lahenduste inseneri poolt.
Rakenduse juurdepääsutoken ja rakenduse võti. Mõlemad on vajalikud iga päringu puhul – token peab olema „Authorization“ päises, võti aga „X-Application-Key“ päises. Loo oma juhtpaneelis müügikanal, et need kohe genereerida – päringut pole vaja.
Avalikult kättesaadav HTTPS-lõpppunkt, mis võtab vastu JSON-POST-päringuid. Arenduse käigus toimib localhost tunneli kaudu. Enne töötlemist kontrollite iga andmepaketi HMAC-SHA256-allkirja.
Teie kujundusfail – PDF, TIFF, JPG või PNG – peab olema kättesaadav HTTPS-i kaudu ilma autentimiseta. RGB värviskeem, kuni 50 MB ja 15 000 pikselit külje kohta. Mitmeleheküljelised PDF-failid on ühe lehekülje kaupa kihiti. Me laadime faili alla ja koostame õiged trükifailid, kui tööd renderdame.
Iga päring suunatakse baas-URL-ile https://api.fabrixa.com/v2/integration kui mõlemad päised on määratud. GET /ping kontrollib enne mis tahes muude toimingute tegemist, kas token ja võti on kehtivad.
Staatus 401 tähendab, et puudub päis või et märge on tühistatud. Staatus 403 tähendab, et autentimisandmed on kehtivad, kuid puudub juurdepääsuõigus ressursile.
# 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
Kataloog kuvab tootevariandid koos nende SKU-koodiga ja variant_id. Iga nimekirja vastus on ümbritsetud standardse links / meta / data ümbrik, seega leheküljenumbrid tuleb märkida next_page link. Salvestatakse kohalikku vahemällu — kataloog ei ole seotud iga päringuga eraldi.
Kõik väljade üksikasjad on esitatud Swaggeri viide.
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" }
]
}
Saada rows (SKU + kogus + allikas PDF), customer ja shipping_address. Määra ise number viitena — kui seda ei ole, loome selle ise. Salvesta tagastatud Fabrixa tellimuse ID oma tellimuse juurde.
Stuudio tellimused asendavad sources fail koos cart_item_key salvestatud kujunduse puhul; kõik muu on identne.
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"
}
}
Määrake oma webhooki URL juhtpaneelis. Me saadame POST-päringu order.created ja order.updated sellele koos kogu tellimuse sisuga, üks x-webhook-signature (HMAC-SHA256) ja x-webhook-topic pealkiri. Kontrolli allkirja, naase 200 kiiresti, töötle asünkroonselt.
Kõik sündmused ja kontrollkoodijupid on lehel veebihookide juhend.
# 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" }
Vead kuvatakse JSON-vormingus, mitte kunagi HTML-vormingus. errors.messages array nimetab, mis ebaõnnestus; koodi 400 korral loetletakse väljad, mille valideerimine ebaõnnestus.
Valideerimisviga, puuduvad või tühistatud volitused, ebapiisavad õigused või tundmatu ressurss.
30 päringut rakenduse kohta minutis. X-RateLimit-Limit ja X-RateLimit-Remaining on igas vastuses.
Serveripoolne. Proovi uuesti, kasutades tagasilükkamist; kui probleem püsib, saada päringu ID oma lahenduste insenerile.
{
"links": { "self": ".../v2/integration/orders" },
"meta": [],
"errors": {
"messages": [
"Application Key is not specified."
]
}
}
Fabrixa lubab iga rakenduse kohta 30 päringut minutis; selle piiri ületamisel saadetakse vastuseks 429 Too Many Requests. Iga vastus sisaldab päiseid X-RateLimit-Limit ja X-RateLimit-Remaining, et integratsioon saaks jälgida järelejäänud kvooti enne piiri saavutamist.
Fabrixa aktsepteerib PDF-, TIFF-, JPG- või PNG-vormingus kujundusfaile RGB-värviskeemis, suurusega kuni 50 MB ja resolutsiooniga kuni 15 000 pikselit külje kohta, millele on võimalik juurde pääseda HTTPS-i kaudu ilma autentimiseta. Mitmeleheküljelisi PDF-faile käsitletakse nii, et iga kiht vastab ühele lehele, ning Fabrixa laadib faili ise alla, et töö renderdamisel luua õiged trükifailid.
Mine WooCommerce’is menüüsse „Seadistused”, seejärel „Täpsemad seaded” ja „REST API” ning lisa võti, millel on lugemis- ja kirjutusõigused. Kleebi saadud ck_-võti, cs_-salasõna ja oma poe domeen Fabrixa-sse, salvesta ning tellimused sünkroniseeritakse automaatselt — impordireegleid saab hiljem muuta kanali seadetest.
Enne esimese tellimuse esitamist on vaja müügikanalilt saada rakenduse juurdepääsutoken ja rakenduse võti, avalik HTTPS-webhooki lõpppunkt, mis kontrollib iga andmepaketi HMAC-SHA256-allkirja, ning HTTPS-i kaudu ilma autentimiseta kättesaadav kujundusmaterjal. Kõik kolm väljastatakse või konfigureeritakse Fabrixa-i juhtpaneelis ning autentimisandmed genereeritakse kohe, kui müügikanal luuakse.
Viga 403 tähendab, et rakenduse juurdepääsutoken ja rakenduse võti on kehtivad, kuid puudub luba taotletava ressursi kasutamiseks. See erineb veast 401, mis tähendab, et puudub nõutav päis või token on tühistatud; mõlemat saab enne edasist arendamist kontrollida GET /ping-päringuga.
Integreerimise tugi, kasutajatunnuste või müügikanalitega seotud probleemid, erinõuded või võimsuse planeerimine – pöörduge tehnilise müügiesindaja (SE) kanali, mitte müügiliini poole. Vastame ühe tööpäeva jooksul.
Võite ühenduda meie REST API-liidese ja tootevoogu kaudu ning meie disainiredaktor Fabrixa Studio on võimalik integreerida teie enda platvormi, nii et see kuvatakse teie enda funktsioonina.
Loe vastust →See on praegu arendamisel; meie meeskond töötab tellimuste automaatse esitamise, toodete, hindade ja laoseisu sünkroniseerimise ning tagastuste automaatse jälgimise kallal.
Loe vastust →Arendajate ressursid: API dokumentatsioon https://www.fabrixa.com/developers/api-documentation · Integreerimisjuhend https://www.fabrixa.com/developers/integration-guide/ · Webhookid https://api.fabrixa.com/docs/integration#webhooks
Loe vastust →Kõik 8 vastust teemal „Integreerimine ja API“ → Küsige meie tugimeeskonnalt →
