01
Імпортувати колекцію
У "Листоноші": File → Import → Link. Вставте URL-адресу JSON-файлу, отриману за допомогою кнопки завантаження вище. Postman додасть колекцію — разом із її змінними — до вашого робочого простору.
Розробники · Колекція Postman
Імпортуйте колекцію. До API за пять хвилин.
Готова колекція Postman із практичними прикладами для інтеграції Fabrixa з API. Введіть свої облікові дані, перегляньте запити та ознайомтеся з реальними відповідями від API, перш ніж написати хоча б один рядок коду інтеграції. Колекція оновлюється разом із версіями API.
Що входить до колекції
Кожна endpoint з прикладами payload.
Розташовані у папках за типами ресурсів. Кожен запит містить готовий приклад тіла запиту, два попередньо налаштовані заголовки автентифікації та збережений приклад відповіді — завдяки цьому ви можете попередньо переглянути структуру відповіді ще до відправлення запиту.
Автентифікація & товари
- GET /ping — перевірити облікові дані
- GET /products — список та пагінація (SKU + variant_id)
- Повні схеми полів у довіднику Swagger
Замовлення
- НАДІСЛАТИ /orders — створити замовлення
- GET /orders/{id}/fulfillments — відстеження виробництва
Студія та webhooks
- GET /v2/studio/customizations/{key}/preview
- Дані webhook + перевірка HMAC (приклад)
Імпорт за 30 секунд
Файл → Імпорт → Посилання → вставити URL-адресу.
02
Відкрийте вкладку «Змінні»
Колекція постачається з власними змінними — base_url вже заповнено; access_token і application_key є заповнювачами. Окремий файл налаштувань середовища не потрібен.
03
Вставте свої ключі
Вставте Application Access Token і Application Key з каналу продажів у вашому Dashboard, натисніть «Зберегти», і кожен запит проходитиме автентифікацію.
Змінні середовища
Що знаходиться у файлі env.
Одна базова URL-адреса, двоє облікових даних, вбудовані в колекцію. Розробляйте на одному каналі продажів, а під час запуску вставте ключі робочого каналу — та сама колекція, ті самі запити.
Змінні колекції
{
"base_url": "https://api.fabrixa.com/v2/integration",
"studio_base": "https://api.fabrixa.com/v2/studio",
"access_token": "APPLICATION_ACCESS_TOKEN",
"application_key": "APPLICATION_KEY"
}
Аутентифікація попередньо налаштована
Обидва заголовки автентифікації, які встановлюються за замовчуванням у кожному запиті.
Кожен запит містить Authorization: Bearer {{access_token}} і X-Application-Key: {{application_key}}, що беруться зі змінних колекції — налаштування заголовків для кожного запиту не потрібне. Перехід з одного каналу продажів на інший полягає лише у редагуванні цих двох змінних: та сама колекція, різні ключі.
Готові приклади
Кожен запит містить приклад тіла запиту та збережений приклад відповіді.
Ця колекція — це не просто короткі URL-адреси: кожен запит містить готовий приклад у тілі запиту, тож ви можете натиснути «Надіслати» і побачити реальні дані. Збережені приклади відповідей розміщуються на панелі «Приклади» для використання в автономному режимі.
Перевірити автентифікацію
Перш за все перевіряє, чи дійсні ваші Application Access Token і Application Key. У разі успіху повертається код 200, а у разі відсутності заголовка — 401.
Перелік товарів
Запит на каталог із розбивкою на сторінки. Повертає товари по сторінках у конверті links / meta / data, із SKU та variant id для кожного товару.
Створити замовлення
Зразок тексту для замовлення однієї футболки з вихідним PDF-файлом, даними клієнта та адресою доставки. Натисніть «Надіслати», щоб переглянути створене замовлення з ідентифікатором Fabrixa.
Відстеження виробництва
Виводить етапи виробництва для кожної позиції (друк, закріплення, прання, пошиття) зі статусами pending / in progress / done / rejected для розміщеного замовлення.
Попередній перегляд Studio
Повертає відтворене зображення попереднього перегляду для збереженої настройки Studio — просто перетягніть його на мініатюру кошика.
Перевірка підпису
Приклад перерахунку підпису HMAC-SHA256 та його порівняння з x-webhook-signature перед обробкою.
Управління версіями
Колекція оновлюється разом з API.
З кожним випуском API оновлена колекція публікується за тим самим URL-адресою. Виконайте повторне імпортування, щоб отримати нові endpoints та приклади даних запитів — існуючі запити у вашій збереженій версії продовжуватимуть працювати, доки ця endpoint не буде фактично виведена з експлуатації.
Стабільна URL-адреса
URL-адреса JSON-колекції є постійною. Під час повторного імпорту завантажується найновіша версія — URL-адреса не змінюється між релізами.
Довідка щодо Changelog
Дивіться changelog для відповідних версій API — що змінилося, що додано, що виводиться з експлуатації.
Політика виведення з ужитку
Для endpoints передбачено 12-місячний період виведення з обігу. У описі колекції позначені запити, що виводяться з обігу, тому їх важко не помітити, перш ніж виникнуть проблеми.
Часті запитання
Колекція «Поштар», відповіді
Як імпортувати колекцію Fabrixa для Postman?
У Postman виберіть «Файл», потім «Імпортувати», потім «Посилання» та вставте URL-адресу колекції у форматі JSON. Postman додасть колекцію разом із її змінними до вашого робочого простору — поле «base_url» буде заповнено заздалегідь, а «access_token» та «application_key» є заповнювачами, які ви повинні замінити на власний токен доступу до додатка та ключ додатка.
Які endpoints входять до колекції Fabrixa у Postman?
Ця колекція охоплює запит GET /ping для перевірки облікових даних, запит GET /products для переліку та пагінації каталогу, запит POST /orders для створення замовлення, запит GET /orders/{id}/fulfillments для відстеження виконання замовлення, endpoint попереднього перегляду Studio, а також готовий приклад перевірки підпису webhook. Вона створена для v2 Integration API і вимагає Postman v10 або пізнішої версії.
Як налаштовується аутентифікація у колекції Fabrixa для Postman?
Кожен запит у колекції вже містить два обов’язкові заголовки — Authorization: Bearer {{access_token}} та X-Application-Key: {{application_key}} — які беруться зі змінних колекції. Вставлення вашого токена доступу до додатка та ключа додатка в ці змінні забезпечує одночасну автентифікацію кожного запиту без необхідності налаштування для кожного запиту окремо.
Чи оновлюється колекція «Fabrixa Postman» при зміні версії API?
Так — у кожному випуску API оновлена колекція публікується за тим самим постійним URL-адресою, тому під час повторного імпортування завантажуються найновіші endpoints та зразки даних. Для endpoints передбачено 12-місячний період виведення з використання, і колекція позначає застарілі запити в їхньому описі ще до того, як виникнуть будь-які проблеми.
Що повертає запит GET /orders/{id}/fulfillments?
Вона отримує інформацію про стан виробництва кожної одиниці товару в розміщеному замовленні, охоплюючи такі етапи, як друк, фіксація, прання та пошиття, стан кожного з яких позначається як «у процесі очікування», «у процесі виконання», «виконано» або «відхилено». Колекція Postman містить приклад, що дозволяє перевірити формат відповіді перед її підключенням до інтеграції.
Завантажити та розпочати
Завантажте колекцію. Надішліть свій перший запит.
Імпортуйте колекцію, введіть облікові дані вашого каналу продажів і надішліть перший запит за лічені хвилини — для початку роботи не потрібно писати код інтеграції.