01
Замовлення
POST /v2/integration/orders
Надіслати замовлення з рядками, вихідними PDF-файлами, даними клієнта та адресою доставки. Повертає ідентифікатор замовлення Fabrixa. Необов'язкові поля для етикетки та відстеження.
Документація API
Один endpoint. Нескінченні продукти.
Кожен Fabrixa SKU, кожна тканина, кожна обробка — доступні через єдиний документований REST API. Вхідні та вихідні дані у форматі JSON. Webhooks для кожного переходу між станами. Самообслуговування ключів API — створіть канал продажів і починайте розробку.
Що ви отримаєте
Побудований на основі того, як насправді працює виробництво.
Документований REST API, що повністю відтворює функціонал платформи — замовлення, fulfilment, налаштування Studio та webhooks. Вхідні та вихідні дані у форматі JSON. Використовуйте його разом із панеллю управління або керуйте всім програмно.
02
Відправлення
GET /orders/{id}/fulfillments
Отримуйте виробничий статус за кожною позицією: кожен крок (друк, закріплення, прання, шиття) зі станами pending / in progress / done / rejected. Або підпишіться на webhooks для push.
03
Studio
вбудовування iframe
Вбудуйте Fabrixa Studio у свій інтернет-магазин. Клієнти можуть налаштовувати товари в режимі реального часу за допомогою подій postMessage для додавання до кошика та повернення, а також URL-адреси попереднього перегляду мініатюр товарів у кошику.
04
Webhooks
order.created / order.updated
Дві теми, payload підписані за допомогою HMAC-SHA256, повне тіло замовлення, до 10 спроб доставки з back-off.
Швидкий старт
Оформіть замовлення в одному POST.
Запит автентифіковано, payload перевірено, слот зарезервовано у виробничій черзі. Підтвердження надійшло за лічені мілісекунди — замовлення вашого клієнта вже обробляється.
Повна схема, усі endpoints, коди помилок, обмеження частоти запитів та приклади інтеграції наведені в технічній документації.
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" } }
Процес інтеграції
Прямий ефір через два тижні. Без проксі, без проміжного програмного забезпечення.
Пряма інтеграція REST у вашу платформу. Не потрібні ні SDK, ні проксі-сервер, ні сторонні коннектори. Стандартний протокол HTTP від вашого стеку до нашого.
01
Повноваження
Отримайте Application Access Token та Application Key, створивши канал продажів у своїй панелі управління. Обидва ці елементи необхідні в кожному запиті: Bearer Token — у полі «Authorization», а Application Key — у полі «X-Application-Key».
02
Каталог
Перегляньте онлайн-довідник Swagger, щоб знайти варіанти SKUs для товарів, які ви хочете продати, а також шаблони фільтрації та пагінації.
03
Замовлення
Під час оформлення замовлення надішліть запит POST із полями rows, sources (URL-адреси PDF-файлів), customer та shipping_address. Збережіть отриманий ідентифікатор замовлення Fabrixa разом із вашим власним номером замовлення.
04
Webhooks
Відкрийте публічну POST-endpoint. Ми підписуємо кожне payload за допомогою HMAC-SHA256 (x-webhook-підпис), щоб ви могли перевірити автентичність перед обробкою.
05
Studio
Необов’язково: вставте iframe від Fabrixa Studio на сторінку вашого товару. Клієнти налаштовують товар у режимі реального часу; їхні налаштування додаються до замовлення за допомогою POST-запиту.
Ресурси для розробників
Все, що потрібно вашій інженерній команді.
Повне посилання на API
Повна документація щодо endpoints, схеми запитів/відповідей, коди помилок, rate limits, автентифікація, інтеграція зі Studio та контракти webhooks — із інтерактивним інтерфейсом Swagger.
Відкриті документи →Розробка з орієнтацією на канал збуту
Створіть спеціальний канал продажів для тестування — розміщуйте тестові замовлення, перевіряйте доставку webhooks, тестуйте граничні випадки — а потім перенаправте реальний трафік на ваш робочий канал. Ваші ключі стають доступними одразу після створення каналу — без необхідності надсилати запит.
Створіть свій обліковий запис →Колекція Postman
Готовий набір запитів із прикладами даних та автентифікацією. Імпортуйте його у свій робочий процес тестування.
Отримати колекцію →
Безпека
Автор з двома заголовками. Підписані webhooks. Обмежена кількість.
Стандартні процедури, жодних несподіванок. Кожен запит автентифікується за допомогою токена Bearer та ключа додатка. Кожен webhook підписується за алгоритмом HMAC для перевірки, при цьому встановлюються передбачувані обмеження частоти запитів для кожного додатка.
Application Access Token
Bearer Token у заголовку Authorization. Ідентифікує застосунок, що робить виклик.
Application Key
Надсилається в заголовку X-Application-Key. Обидва параметри є обов’язковими для кожного запиту — відсутність хоча б одного з них призводить до повернення коду 401.
Шифрування TLS
Тільки HTTPS на api.fabrixa.com. Прості текстові запити відхиляються на межі.
Підписи webhooks
Кожен webhook підписується за допомогою алгоритму HMAC-SHA256, а підпис надсилається у заголовку x-webhook-signature. Перевірте його перед обробкою.
Rate limits
30 запитів на додаток за хвилину. У кожному відповіді повертаються параметри X-RateLimit-Limit та X-RateLimit-Remaining.
Повторні спроби webhook
До 10 спроб доставки у разі отримання відповіді, що не належить до кодів 2xx або 3xx. Після 10-ї невдалої спроби webhook деактивується.
Часті запитання
«Інтеграція API», відповідь
Як пройти аутентифікацію за допомогою Fabrixa та API?
Кожен запит повинен містити два заголовки: токен доступу до додатка, який надсилається як токен Bearer у заголовку Authorization, та ключ додатка у заголовку X-Application-Key. Обидва вони генеруються в момент створення каналу продажів у панелі управління Fabrixa, і запит відхиляється з кодом помилки 401, якщо будь-який із цих заголовків відсутній.
Чи можу я протестувати режими Fabrixa та API перед тим, як відправляти реальні замовлення?
Так — створіть спеціальний канал продажів для тестування, розмістіть тестові замовлення, перевірте доставку webhooks та виявіть крайні випадки, а потім перенаправте реальний трафік на ваш робочий канал, коли він запрацює. Після реєстрації та створення цього каналу ваш токен доступу до додатка та ключ додатка стають доступними одразу, без необхідності подавати окремий запит.
Чи шифрується інтеграція Fabrixa API за допомогою HTTPS?
Так — сервіс API на api.fabrixa.com підтримує лише HTTPS, і будь-який запит у вигляді звичайного тексту відхиляється на периферії. Кожен запит також проходить автентифікацію за допомогою токена Bearer та ключа додатка, а кожне тіло webhook підписується за допомогою HMAC-SHA256, щоб його можна було перевірити перед обробкою.
Що повертає запит POST на /v2/integration/orders?
Завірений запит POST на /v2/integration/orders перевіряє вміст запиту, резервує місце в робочій черзі та повертає підтвердження з ідентифікатором замовлення Fabrixa у мілісекундах, а також додаткові поля для транспортної етикетки та відстеження. Після цього виконання замовлення можна відстежувати за кожною позицією або отримувати відповідну інформацію через webhooks.
Чи потрібен мені SDK або проксі для інтеграції з Fabrixa та API?
Ні — інтеграція fabrixa здійснюється у вигляді прямого REST-з’єднання через стандартний протокол HTTP, без необхідності використання SDK, проксі-сервера чи сторонніх коннекторів. Ви звертаєтеся до API безпосередньо зі свого власного стеку за допомогою запитів і відповідей у форматі JSON, а для сповіщення про зміни стану використовуються webhooks.
Почніть створювати
Створіть канал продажів і почніть розробку вже сьогодні.
Зареєструйтеся, створіть канал продажів — і ваші облікові дані для API будуть готові одразу. Потрібна допомога? Наші Solutions Engineers відповідають протягом 24 годин — більшість команд починають роботу вже за два тижні.