01
Замовлення
POST /v2/integration/orders
Надіслати замовлення з рядками, вихідними PDF-файлами, даними клієнта та адресою доставки. Повертає ідентифікатор замовлення Fabrixa. Необов'язкові поля для етикетки та відстеження.
Документація API
Один endpoint. Нескінченні продукти.
Кожен Fabrixa SKU, кожна тканина, кожна обробка — доступні через єдиний документований REST-інтерфейс API. Вхідні та вихідні дані у форматі JSON. webhooks для кожного переходу між станами. Самообслуговування ключів API — створіть канал продажів і починайте розробку.
Що ви отримаєте
Побудований на основі того, як насправді працює виробництво.
Документований REST-інтерфейс API, що повністю відтворює функціонал платформи — замовлення, виконання замовлень, налаштування 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
Повноваження
Отримайте токен доступу до додатка та ключ додатка, створивши канал продажів у своїй панелі управління. Обидва ці елементи необхідні в кожному запиті: токен Bearer — у полі «Authorization», а ключ додатка — у полі «X-Application-Key».
02
Каталог
Перегляньте онлайн-довідник Swagger, щоб знайти варіанти SKUs для товарів, які ви хочете продати, а також шаблони фільтрації та пагінації.
03
Замовлення
Під час оформлення замовлення надішліть запит POST із даними про рядки, джерела (URL-адреси PDF-файлів), клієнта та адресу доставки. Збережіть отриманий ідентифікатор замовлення Fabrixa разом із вашим власним номером замовлення.
04
Webhooks
Відкрийте публічну POST-endpoint. Ми підписуємо кожне payload за допомогою HMAC-SHA256 (x-webhook-підпис), щоб ви могли перевірити автентичність перед обробкою.
05
Studio
Необов’язково: вставте iframe від Fabrixa Studio на сторінку вашого товару. Клієнти налаштовують товар у режимі реального часу; їхні налаштування додаються до замовлення за допомогою POST-запиту.
Ресурси для розробників
Все, що потрібно вашій інженерній команді.
Повне посилання на API
Повна документація щодо endpoints, схеми запитів/відповідей, коди помилок, обмеження частоти запитів, автентифікація, інтеграція зі 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 будуть готові одразу. Потрібна допомога? Наші Solutions Engineers відповідають протягом 24 годин — більшість команд починають роботу вже за два тижні.