Функція «Fabrixa» (друк на замовлення) API дозволяє будь-якій платформі або інтернет-магазину POD відправляти замовлення та відстежувати його життєвий цикл протягом order.created і order.updated webhooks, а компанія Fabrixa займеться друком, пакуванням та відправкою продукції під вашим брендом — від однієї одиниці товару по всій території ЄС. Ви створюєте досвід покупки, а ми забезпечуємо оперативне виробництво текстилю на його основі. Без мінімального обсягу замовлення, без плати за налаштування, без логотипу Fabrixa на посилці.
Цей допис — це огляд інтеграції API (v2), викладений простою мовою, для розробників, які розглядають Fabrixa як рівень виконання замовлень. Якщо ви бажаєте скоріше ознайомитися з довідковою інформацією, повний Документація API та поетапно посібник з інтеграції ми готові, коли ви будете готові.
Для чого призначений API
Fabrixa — це платформа для реактивного друку на текстилі: єдина панель управління для каналів продажів, дизайну, виробництва та відправки. Більшість клієнтів підключаються через Shopify, WooCommerce або Fabrixa Studio. Інтеграція API — це четвертий варіант, розроблений для платформ POD та розробників, які вже мають власний інтернет-магазин і бажають отримати програмний контроль над виконанням замовлень.
Ви звертаєтеся до API, щоб відправити замовлення. Fabrixa їх виконує: реактивний друк на бавовні та льоні в Португалії та Іспанії, сублімаційний друк на поліестері в Нідерландах. Посилки відправляються під вашим брендом, із вашою зворотною адресою, і на упаковці ніде немає позначок Fabrixa. Ваші клієнти ніколи не дізнаються про наше існування, якщо ви їм про це не скажете.
Що робить API
- Пінг — простий тест на працездатність, який дозволяє перевірити, чи дійсні ваші облікові дані та чи працює з’єднання, перш ніж надсилати будь-які реальні дані.
- Продукти — ознайомтеся з каталогом, на основі якого ви створюєте свою колекцію: одяг, домашній текстиль та тканини на метраж, а також основи та варіанти, доступні для друку.
- Замовлення — створити замовлення та перевірити його статус. Це основа будь-якої інтеграції: вводяться дані про рядки, джерела, клієнта та доставку; у відповідь отримуємо замовлення з можливістю відстеження.
- Виконання замовлень — відстежуйте виробництво та відвантаження у міру виготовлення та відправлення товарів, щоб ваша платформа могла надавати продавцям точну інформацію про статус замовлень.
- Studio — додайте індивідуальний дизайн у Fabrixa Studio (наш вбудований конфігуратор продуктів під власний бренд) до замовлення за його
cart_item_key, тому те, що розробив покупець, — це саме те, що буде надруковано.
Аутентифікація та обмеження частоти запитів
Інтеграція API (v2) розміщена за базовою URL-адресою https://api.fabrixa.com/v2/integration. Кожен запит містить два заголовки:
| Заголовок | Мета |
|---|---|
Авторизація: «На пред’явника» |
Ваш токен API — ідентифікує запит та надає дозвіл на його виконання. |
X-Application-Key: |
Ключ вашого додатка — працює в парі з токеном, тому обидва повинні бути присутніми. |
Обмеження частоти запитів становить 30 запитів на хвилину. Цього цілком достатньо для трафіку, пов’язаного з обробкою замовлень, але це означає, що масові операції слід виконувати з певним інтервалом, а не в щільній циклічній послідовності. Потрібно коректно обробляти обмеження: при його досягненні слід зменшити навантаження та використовувати webhooks (див. нижче) замість постійного опитування.
webhooks: реагуйте на стан, а не перевіряйте його
Замість того, щоб постійно запитувати “це вже готово?”, підпишіться на webhooks, і нехай Fabrixa повідомляє вас, коли щось зміниться. Інтеграція API генерує дві події:
- order.created — спрацьовує, коли замовлення приймається у виробництво. Використовуйте цю функцію, щоб підтвердити отримання замовлення продавцю та позначити його як таке, що виконується.
- order.updated — спрацьовує під час проходження замовлення через етапи виробництва та відправки, включаючи відстеження. Використовуйте цю функцію, щоб синхронізувати стан вашої платформи, не перевищуючи ліміт запитів.
З огляду на дві події та обмеження у 30 операцій на хвилину, правильно реалізована інтеграція ледь досягає цього ліміту: спочатку відправляється запит, а потім відбувається реакція на отриману відповідь.
Потік замовлень від початку до кінця
Який би варіант ви не обрали, схема залишається однаковою:
- Підключіться — інтернет-магазин (Shopify або WooCommerce) або API.
- Дизайн — налаштуйте дизайн у Fabrixa Studio або надайте PDF-файл, готовий до друку.
- Надіслати замовлення — через API, із рядками про товари, даними про клієнта та адресою доставки.
- Ми виробляємо та відправляємо — Fabrixa здійснює друк, пакування та відправку продукції під вашою торговою маркою.
Коротка примітка щодо якості, адже саме тому продавці обирають реактивні барвники: реактивний барвник утворює ковалентний зв’язок із целюлозою в бавовняному волокні та назавжди закріплюється під дією тепла й пари. Колір стає частиною волокна — без поверхневого шару, без тріщин у місцях згину — тому на дотик тканина нагадує нефарбовану бавовну і, як правило, зберігає колір протягом понад 600 циклів прання. Щодо термінів виготовлення, то для одягу, виробленого в Португалії, вони становлять приблизно 6–9 робочих днів.
Чому платформи створюються на базі Fabrixa
- MOQ 1 — від однієї штуки до десятків тисяч. Без мінімального обсягу замовлення, без плати за налагодження, без контрактів.
- «White-label» за замовчуванням — на кожній посилці має бути логотип клієнта, а не наш.
- Короткий ланцюг поставок у ЄС — перевезення вантажів по території Португалії, Іспанії та Нідерландів, а не на великі відстані.
- Справжній реактивний друк — Органічна бавовна, сертифікована за стандартом GOTS, як основний матеріал, а також сертифікати OEKO-TEX Standard 100 та Made in Green.
Часті запитання
Чи потрібно використовувати Fabrixa Studio, щоб користуватися API?
Ні. Функція «Студія» є необов’язковою. Замість цього ви можете надіслати разом із замовленням PDF-файл, готовий до друку. Функція «Студія» використовується лише в тому випадку, якщо ви хочете, щоб покупці могли персоналізувати товар у вашому інтернет-магазині, і ви додаєте цей дизайн до замовлення шляхом cart_item_key.
Як здійснювати аутентифікацію запитів?
При кожному виклику надсилайте два заголовки: Авторизація: «На пред’явника» і X-Application-Key:. Обидва елементи є обов’язковими — якщо один з них відсутній, заявка буде відхилена.
Що станеться, якщо я досягну ліміту частоти запитів?
Обмеження API становить 30 запитів на хвилину. Якщо ви перевищите це обмеження, зробіть паузу та спробуйте ще раз, замість того щоб надмірно навантажувати endpoint. Для перевірки змін статусу використовуйте order.created і order.updated webhooks замість періодичного опитування — вони забезпечують синхронізацію без витрачання запитів.
Чи справді це «white-label»-рішення?
Так. Посилки відправляються під вашим брендом із вашою зворотною адресою, і за замовчуванням на них не вказується логотип Fabrixa. Ваші кінцеві клієнти ніколи нас не бачать.
Почніть створювати
Найшвидший спосіб потрапити туди — це посібник з інтеграції, за повної підтримки Документація API. Якщо ви спочатку хочете побачити, як все це поєднується, то огляд платформи проходить через канали, студію, виробництво та відправку. А якщо ви хочете перевірити, чи підійде це для вашої платформи, поспілкуйтеся з нашою командою — ми з радістю розглянемо ваш конкретний випадок використання.
