Mine otse põhilise sisu juurde
Ekraanil kuvatakse päring Fabrixa API — JSON-vormingus tellimuse andmed koos autentimise päistega, seoses kootud tekstiiliga
API dokumentatsioon

Ü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.

REST · JSON · Webhookid · Studio sisseehitatud funktsioon · Swagger

Mida saate

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.

01
Tellimused
POST /v2/integration/orders

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.

02
Fulfilment
GET /tellimused/{id}/täitmised

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.

03
Stuudio
iframe'i sisseviimine

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.

04
Veebihookid
order.created / order.updated

Kaks teemat: HMAC-SHA256-ga allkirjastatud andmepaketid, täielik tellimuse sisu, 10 korduskatsega edastamine koos ooteajaga.

Kiirstart

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 /v2/integration/orders
// 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"
  }
}
Integreerimise protsess

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.

01
Kvalifikatsioonid

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.

02
Kataloog

Sirvige Swaggeri reaalajas viidet, et leida müüdavate toodete variandid SKUs, samuti filtreerimis- ja lehekülgede jaotamise mustrid.

03
Tellimused

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.

04
Veebihookid

Ava avalik POST-lõpppunkt. Me allkirjastame iga andmepaketi HMAC-SHA256-ga (x-webhook-signature), et saaksid enne töötlemist selle autentsust kontrollida.

05
Stuudio

Vabatahtlik: lisage Fabrixa Studio iframe oma tootelehele. Kliendid saavad toodet kohandada reaalajas; nende kohandused lisatakse tellimusele POST-päringu abil.

Arendajate ressursid

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 →
Turvalisus

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.

KKK

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.

Alusta ehitamist

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.

Teadmistebaas

Küsimused integratsioonide ja API kohta?

Kõik 8 vastust teemal „Integreerimine ja API“ → Küsige meie tugimeeskonnalt →