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
Дивіться журнал змін для відповідних версій API — що змінилося, що додано, що виводиться з експлуатації.
Політика виведення з ужитку
Для endpoints передбачено 12-місячний період виведення з обігу. У описі колекції позначені запити, що виводяться з обігу, тому їх важко не помітити, перш ніж виникнуть проблеми.
Завантажити та розпочати
Завантажте колекцію. Надішліть свій перший запит.
Імпортуйте колекцію, введіть облікові дані вашого каналу продажів і надішліть перший запит за лічені хвилини — для початку роботи не потрібно писати код інтеграції.