Є два способи надсилати замовлення до Fabrixa: підключити магазин, яким ви вже керуєте — Shopify або WooCommerce — без написання коду, або створити його безпосередньо в Інтеграції API. У цьому посібнику розглянуто обидва варіанти: підключення каналу продажів за лічені хвилини або проходження всього процесу від авторизації до виконання замовлення за п’ятнадцять хвилин.
Більшість магазинів взагалі не використовують API. Додайте Fabrixa як канал продажів, і замовлення з вашого магазину надходитимуть безпосередньо у виробництво — товари синхронізуються, статуси оновлюються, при цьому не потрібно писати чи підтримувати код. Маршрут API, описаний далі, призначений для індивідуальних інтерфейсів магазинів та платформ POD.
На панелі управління відкрийте Create channel та оберіть тип інтеграції. Кожен канал зберігає власні товари, імпортовані замовлення та правила імпорту — підключайте стільки каналів, скільки використовуєте.
Ключі копіювати не потрібно. Надайте дозвіл Fabrixa у панелі адміністратора Shopify — і з’єднання буде встановлено.
Create channel, виберіть Shopify.Інтернет-магазин на базі WordPress підключається за допомогою пари ключів REST для читання/запису, які генеруються в WooCommerce та вводяться в Fabrixa один раз.
Settings → Advanced → REST API → Add key з Читання/запис права доступу.ck_ ключ, cs_ секрет і домен вашого магазину в Fabrixa.Продаєте товари, виготовлені на замовлення? Fabrixa Studio — редактор дизайну «white-label» — також доступний у магазинах Shopify та WooCommerce, тож ваші покупці можуть персоналізувати товари під вашим брендом. Див. Fabrixa Studio →
У вікні «Канали» магазини, підключені до системи, відображаються поруч із вашими каналами API та каналами партнерів — із синхронізованими товарами, отриманими замовленнями, останнім імпортованим каталогом та виручкою за кожним каналом. Коли будете готові, переведіть канал із режиму «чернетки» у режим «активний»; це не вплине на подальші процеси.
Ви вирішили створити власний інтернет-магазин або власну платформу POD? У подальшій частині цього посібника розглядається підхід API — від авторизації до виконання замовлення за чотири кроки.
Щоб перейти від нуля до активного замовлення, потрібно виконати три кроки. Усі вони здійснюються через вашу панель управління Fabrixa або за допомогою вашого інженера з рішень.
Токен доступу до додатка та ключ додатка. Обидва ці елементи є обов’язковими для кожного запиту — токен у заголовку Authorization, а ключ — у заголовку X-Application-Key. Створіть канал продажів у своїй панелі управління, щоб миттєво їх згенерувати — запит не потрібен.
Публічно доступна HTTPS-точка кінцевого з'єднання, яка приймає запити JSON методом POST. Під час розробки через тунель працює localhost. Перед обробкою ви перевіряєте підпис HMAC-SHA256 для кожного payload.
Ваш файл із макетом — у форматі PDF, TIFF, JPG або PNG — доступний через HTTPS без авторизації. Кольорова гама RGB, розмір до 50 МБ і 15 000 пікселів на кожну сторону. У багатосторінкових PDF-файлах кожна сторінка розміщується на окремому шарі. Ми завантажуємо файл і формуємо правильні файли для друку під час рендерингу замовлення.
Кожен запит надходить на базову URL-адресу https://api.fabrixa.com/v2/integration з налаштованими обома заголовками. GET /ping перевіряє, чи токен і ключ є дійсними, перш ніж виконувати будь-які інші дії.
Статус 401 означає, що відсутній заголовок або токен було скасовано. Статус 403 означає, що облікові дані є дійсними, але не мають доступу до цього ресурсу.
# 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
Каталог повертає варіанти товарів із їхніми кодами SKU та variant_id. Кожна відповідь зі списку обгорнута у стандартний links / meta / data конверт, тому розбийте на сторінки за допомогою next_page посилання. Зберігати в локальному кеші — каталог не формується для кожного запиту окремо.
Повна інформація про поле наведена в Довідка щодо Swagger.
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" }
]
}
Надіслати rows (SKU + кількість + вихідний PDF-файл), customer і shipping_address. Встановіть власний number як посилання — якщо його не вказано, ми його згенеруємо. Збережіть повернутий ідентифікатор замовлення Fabrixa разом із вашим замовленням.
Замовлення студії замінюють sources файл із cart_item_key збереженого дизайну; все інше залишається незмінним.
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"
}
}
Вкажіть URL-адресу webhook в панелі управління. Ми надсилаємо POST-запити order.created і order.updated на цю адресу разом із повним тілом замовлення, x-webhook-signature (HMAC-SHA256) та x-webhook-topic заголовком. Перевірити підпис, повернути 200 швидко, виконувати асинхронно.
Усі події та фрагменти коду для перевірки містить довідник webhooks.
# 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" }
Помилки повертаються у форматі JSON, а не HTML. errors.messages масив містить назви елементів, у яких сталася помилка; у разі коду 400 у ньому перелічено поля, які не пройшли перевірку.
Помилка перевірки, відсутні або анульовані облікові дані, недостатні права доступу або невідомий ресурс.
30 запитів на додаток за хвилину. X-RateLimit-Limit і X-RateLimit-Remaining вміщені в кожній відповіді.
На стороні сервера. Спробуйте ще раз із застосуванням алгоритму відстрочки; якщо проблема не зникне, надішліть ідентифікатор запиту своєму інженеру з вирішення проблем.
{
"links": { "self": ".../v2/integration/orders" },
"meta": [],
"errors": {
"messages": [
"Application Key is not specified."
]
}
}
Fabrixa дозволяє 30 запитів на додаток за хвилину; у разі перевищення цього ліміту повертається відповідь 429 «Too Many Requests». Заголовки X-RateLimit-Limit та X-RateLimit-Remaining додаються до кожної відповіді, щоб інтеграція могла відстежувати залишок квоти до досягнення ліміту.
Fabrixa приймає файли макетів у форматах PDF, TIFF, JPG або PNG у колірній гамі RGB, розміром до 50 МБ та з роздільною здатністю до 15 000 пікселів на сторону; доступ до них здійснюється через HTTPS без авторизації. Багатосторінкові PDF-файли обробляються як одна сторінка на кожен шар, і Fabrixa самостійно завантажує файл для формування правильних файлів для друку під час рендерингу завдання.
У WooCommerce перейдіть до розділу «Налаштування», потім — «Додаткові», а потім — «REST API» і додайте ключ із правами на читання та запис. Вставте отриманий ключ ck_, секретний код cs_ та домен вашого магазину в поле Fabrixa, збережіть налаштування, і замовлення синхронізуються автоматично — правила імпорту можна змінити пізніше в налаштуваннях каналу.
Перед тим, як оформити перше замовлення, вам знадобляться токен доступу до додатка та ключ додатка від каналу продажів, публічна endpoint webhook HTTPS, яка перевіряє підпис HMAC-SHA256 у кожному payload, а також графічні матеріали, доступні через HTTPS без аутентифікації. Усі три елементи видаються або налаштовуються в панелі управління Fabrixa, а облікові дані генеруються миттєво під час створення каналу продажів.
Код 403 означає, що токен доступу до додатка та ключ додатка є дійсними, але їм бракує дозволу на доступ до запитуваного ресурсу. Це відрізняється від коду 401, який означає, що відсутній необхідний заголовок або токен було анульовано; обидва випадки можна перевірити за допомогою запиту GET /ping перед подальшою розробкою.
З питань підтримки інтеграції, проблем із обліковими даними чи каналами збуту, індивідуальних вимог або планування потужностей — звертайтеся до технічного відділу з підтримки клієнтів (SE), а не до відділу продажів. Відповідь буде надано протягом одного робочого дня.
