Всеки Fabrixa и SKU, всяка тъкан, всяко покритие — достъпни чрез един документиран REST API. Вход и изход в JSON формат. Уебхукове за всеки преход между състояния. Ключове за самообслужване API — създайте канал за продажби и започнете да изграждате.
Документиран REST API, който отразява функционалността на платформата — поръчки, изпълнение, персонализиране в Studio и уебхукове. Вход и изход в JSON формат. Използвайте го заедно с таблото за управление или управлявайте всичко програмно.
Изпратете поръчка с редове, изходни PDF файлове, данни за клиента и адрес за доставка. Връща идентификационния номер на поръчката Fabrixa. Полетата за етикет за доставка и проследяване са по избор.
Извличане на статуса на производството по отделни позиции: всеки етап (печат, поправка, пране, шиене) със статуси „в очакване“, „в процес“, „завършено“ и „отхвърлено“. Или абонирайте се за уебхукове, за да получавате известия.
Вградете Fabrixa Studio във Вашия онлайн магазин. Клиентите персонализират продуктите в реално време, като се използват събития „postMessage“ за добавяне в количката и връщане назад, както и URL адрес за предварителен преглед на миниатюрите в количката.
Две теми: данни, подписани с HMAC-SHA256, тяло на съобщението в пълен ред, доставка с 10 опита и отлагане.
Заявката е удостоверена, данните са проверени, мястото в производствената опашка е запазено. Потвърждението пристига за милисекунди — поръчката на Вашия клиент вече е в процес на изпълнение.
Пълната схема, всички крайни точки, кодовете за грешки, ограниченията за честотата на заявките и примерите за интеграция са описани в техническата документация.
// 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" } }
Директна REST интеграция във Вашата платформа. Не се изисква SDK, прокси сървър или конектор на трета страна. Стандартен HTTP от Вашия стек към нашия.
Получете токен за достъп до приложението и ключ за приложението, като създадете канал за продажби в таблото си за управление. И двете са задължителни при всяко заявка: токенът „Bearer“ при авторизацията, а ключът за приложението – в полето „X-Application-Key“.
Разгледайте онлайн справочника на Swagger, за да намерите вариантите SKUs за продуктите, които искате да продавате, както и шаблоните за филтриране и разпределение на страниците.
При финализиране на поръчката изпратете POST заявка, съдържаща редове, източници (URL адреси на PDF файлове), клиент и адрес за доставка. Запишете върнатия идентификационен номер на поръчката от Fabrixa срещу Вашия собствен референтен номер на поръчката.
Публикувайте публична POST крайна точка. Подписваме всеки полезен товар с HMAC-SHA256 (x-webhook-signature), за да можете да проверите автентичността му преди обработката.
По избор: вмъкнете iframe-а на Fabrixa Studio в страницата на Вашия продукт. Клиентите персонализират на живо; прикачват своите персонализации към поръчката чрез POST.
Пълна документация за крайните точки, схеми за заявки/отговори, кодове за грешки, ограничения на честотата, удостоверяване, вграждане в Studio и договори за уебхукове — с интерактивен интерфейс на Swagger.
Отвори документи →Създайте специален канал за продажби, върху който да изградите системата — подайте тестови поръчки, проверете доставката на уебхукове, тествайте крайни случаи — след което насочете реален трафик към Вашия активен канал. Ключовете Ви са готови в момента, в който създадете канала — без необходимост от подаване на заявка.
Създайте своя профил →Предварително конфигуриран набор от заявки с примерни данни и автентификация. Импортирайте го във Вашия работен процес за тестване.
Вижте колекцията →Стандартни практики, без изненади. Всяко заявка се удостоверява както с токен от типа „Bearer“, така и с ключ на приложението. Всеки уебхук е подписан с HMAC за проверка, като за всяко приложение са определени предвидими ограничения на честотата на заявките.
Токен „Bearer“ в заглавката „Authorization“. Идентифицира приложението, което извършва заявката.
Изпращат се в заглавката X-Application-Key. И двете са задължителни за всяко заявка — липсата на някоя от тях води до отговор 401.
На api.fabrixa.com се използва само HTTPS. Заявките в обикновен текст се отхвърлят на границата.
Всеки уебхук е подписан с HMAC-SHA256, като подписът се изпраща в заглавката „x-webhook-signature“. Проверете го преди обработката.
30 заявки на приложение на минута. При всеки отговор се връщат X-RateLimit-Limit и X-RateLimit-Remaining.
До 10 опита за доставка при отговор, различен от 2xx или 3xx. Уебхукът се деактивира след 10-ия неуспешен опит.
Всяко заявка трябва да съдържа два хедъра: токен за достъп до приложението, изпратен като Bearer токен в хедъра „Authorization“, и ключ на приложението в хедъра „X-Application-Key“. И двата се генерират в момента, в който създадете канал за продажби в таблото за управление на Fabrixa, а заявката се отхвърля с код 401, ако липсва някой от хедърите.
Да — създайте специален канал за продажби, върху който да работите, подайте тестови поръчки, проверете доставката на уебхуковете и тествайте крайните случаи, а след това насочете реален трафик към Вашия активен канал, веднага щом той заработи. Регистрацията и създаването на този канал правят Вашия токен за достъп до приложението и ключа на приложението незабавно достъпни, без да е необходима отделна стъпка за заявка.
Да — API работи само през HTTPS на api.fabrixa.com, а всяко заявка в обикновен текст се отхвърля още на входа. Всяко заявка се удостоверява както с Bearer токен, така и с ключ на приложението, а всеки полезен товар на уебхук е подписан с HMAC-SHA256, за да може да бъде проверен преди обработката.
Автентифицирано POST заявка към /v2/integration/orders проверява валидността на полезния товар, запазва място в производствената опашка и връща потвърждение с идентификационния номер на поръчката Fabrixa в милисекунди, заедно с опционални полета за етикет за доставка и проследяване. След това изпълнението на поръчката може да се проследява по отделни позиции или да Ви се изпраща чрез уебхукове.
Не — интеграцията с fabrixa представлява пряка REST връзка чрез стандартен HTTP протокол, без да се изисква SDK, прокси сървър или конектор на трета страна. Можете да се свържете с fabrixa директно от Вашия собствен стек, като използвате JSON заявки и отговори, както и уебхукове за промени в състоянието.
Регистрирайте се, създайте канал за продажби и Вашите данни за достъп до API ще бъдат готови веднага. Имате ли нужда от помощ? Нашите инженери по решения отговарят в рамките на 24 часа — повечето екипи започват работа в рамките на две седмици.
Ресурси за разработчици: Документация за API https://www.fabrixa.com/developers/api-documentation · Ръководство за интеграция https://www.fabrixa.com/developers/integration-guide/ · Уебхукове https://api.fabrixa.com/docs/integration#webhooks
Прочетете отговора →Всяка поръчка съдържа списък с пратки, който се връща при заявката GET /orders/{id}, както и в уведомлението order.updated, което се задейства при всяка промяна в статуса или данните за проследяване на дадена пратка.
Прочетете отговора →Можете да се свържете чрез нашия REST API и продуктов фийд, а Fabrixa Studio – нашият редактор за дизайн – може да бъде вграден във Вашата собствена платформа, така че да изглежда като Ваша собствена функция.
Прочетете отговора →Всички 8 отговора по темата „Интеграции и API“ → Свържете се с екипа ни за поддръжка →
