Pāriet uz galveno saturu
Ekrānā redzams pieprasījums „Fabrixa API“ — JSON pasūtījuma dati ar autentifikācijas galvenēm, attiecībā uz austu tekstilmateriālu
API dokumentācija

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.

REST · JSON · Webhooks · Studio iestrāde · Swagger

Ko jūs saņemat

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.

01
Pasūtījumi
POST /v2/integration/orders

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.

02
Fulfilment
GET /orders/{id}/fulfillments

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.

03
Studija
iframe iestrāde

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.

04
Webhooki
order.created / order.updated

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.

Ātrs sākums

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 /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"
  }
}
Integrācijas process

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.

01
Akreditācijas dokumenti

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

02
Katalogs

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.

03
Pasūtījumi

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.

04
Webhooki

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.

05
Studija

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.

Resursi izstrādātājiem

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 →
Drošība

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.

Bieži uzdotie jautājumi

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.

Sāciet būvēt

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

Zināšanu bāze

Jautājumi par integrācijām un API?

Visas 8 atbildes par integrācijām un API → Jautājiet mūsu atbalsta komandai →