01
Импортиране на колекцията
В Postman: File → Import → Link. Поставете URL адреса на JSON файла от бутона за изтегляне по-горе. Postman добавя колекцията — заедно с нейните променливи — към Вашето работно пространство.
Разработчици · Колекция на Postman
Импортирайте колекцията. Постигнете API за пет минути.
Готова колекция в Postman с практически примери за интеграция на Fabrixa с API. Въведете своите идентификационни данни, прегледайте заявките и вижте реалните отговори от API, преди да напишете и един ред код за интеграция. Колекцията се актуализира при промени във версиите на API.
Какво включва колекцията
Всяка крайна точка, с примерни данни.
Организирани в папки по ресурси. Всяко заявка се доставя с готово тяло на примера, с предварително зададени два заглавни реда за удостоверяване и запазен пример за отговор — така че можете да видите как ще изглежда отговорът, преди да изпратите заявката.
Авторство и продукти
- ВЗЕМИ /ping — проверка на данните за достъп
- ВЗЕМИ /products — списък и разпределение по страници (SKU + variant_id)
- Схеми на пълното поле в справочника на Swagger
Поръчки
- ПУБЛИКАЦИЯ /поръчки — създаване на поръчка
- ВЗЕМИ /orders/{id}/fulfillments — проследяване на производството
Студио и уебхукове
- ВЗЕМИ /v2/studio/customizations/{key}/preview
- Данни в уебхука + HMAC проверка (пример)
Импортиране за 30 секунди
Файл → Импортиране → Връзка → Поставяне на URL адрес.
02
Отворете раздела „Променливи“
Колекцията се доставя със свои собствени променливи — base_url е предварително попълнено; access_token и application_key са заместващи символи. Не е необходим отделен файл с настройки на средата.
03
Поставете ключовете си
Въведете токена за достъп до приложението и ключа на приложението от даден канал за продажби в таблото си, натиснете „Запази“ и всяко заявка ще бъде удостоверено.
Променливи на средата
Какво се съдържа във файла „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-адреси с кратки линкове — всяко заявка съдържа тяло с готов пример, така че можете да натиснете „Изпрати“ и да видите реални данни. Запазените примерни отговори се намират в панела „Примери“ за справка офлайн.
Проверка на автентичността
Преди всичко проверява дали токенът за достъп на приложението и ключът на приложението са валидни. Връща код 200 при успех, 401, ако липсва заглавен ред.
Списък с продукти
Заявка за каталог с раздели на страници. Връща продуктите страница по страница в пакета с връзки / метаданни / данни, като за всеки артикул се посочват SKU и идентификаторът на варианта.
Създаване на поръчка
Примерно съдържание за поръчка на една бройка тениска с изходен PDF файл, данни за клиента и адрес за доставка. Натиснете „Изпрати“, за да видите създадената поръчка с нейния идентификационен номер Fabrixa.
Проследяване на производството
Извежда производствените етапи за всеки артикул (печат, фиксиране, пране, шиене) със статуси „в очакване“, „в процес“, „завършено“ и „отхвърлено“ за дадена поръчка.
Предварителен преглед на студиото
Връща визуализираното изображение за предварителен преглед на запазена персонализация в Studio — просто го поставете като миниатюра в кошницата.
Проверка на подписа
Пример с подробно описание за преизчисляване на HMAC-SHA256 подписа и сравняването му с x-webhook-signature преди обработката.
Управление на версиите
Колекцията се актуализира едновременно с актуализацията на API.
Всяка версия на API предоставя актуализирана колекция на същия URL адрес. Извършете повторен импорт, за да включите новите крайни точки и примерните данни — съществуващите заявки във Вашата запазена версия продължават да работят, докато съответната крайна точка не бъде официално премахната.
Постоянен URL адрес
URL адресът на JSON колекцията е постоянен. При повторен импорт се изтегля най-новата версия — URL адресът никога не се променя между отделните версии.
Справка за списъка с промените
Вижте списък с промените за съответните бележки към версия API — какво се е променило, какво е добавено и какво вече не се поддържа.
Политика за премахване на функции
За крайните точки се предвижда 12-месечен период на извеждане от употреба. Колекцията отбелязва изведените от употреба заявки в описанието, така че е трудно да бъдат пропуснати, преди да възникнат проблеми.
Често задавани въпроси
Колекцията „Пощальонът“ – отговори
Как да импортирам колекцията „Fabrixa“ от Postman?
В Postman изберете „Файл“, след това „Импортиране“, след това „Връзка“ и поставете JSON URL адреса на колекцията. Postman добавя колекцията заедно с нейните променливи във Вашето работно пространство — полето „base_url“ е предварително попълнено, докато „access_token“ и „application_key“ са заместващи символи, които трябва да замените със собствения си токен за достъп до приложението и ключ за приложението.
Кои крайни точки са включени в колекцията „Fabrixa“ в Postman?
Колекцията включва GET /ping за проверка на идентификационните данни, GET /products за извеждане на списък и разпределяне на каталога по страници, POST /orders за създаване на поръчка, GET /orders/{id}/fulfillments за проследяване на производството, крайната точка за предварителен преглед на Studio, както и работещ пример за проверка на подписа на уебхук. Тя е създадена за v2 Integration API и изисква Postman v10 или по-нова версия.
Как се настройва удостоверяването в колекцията „Fabrixa Postman“?
Всяко заявка в колекцията вече съдържа двата задължителни хедъра — Authorization: Bearer {{access_token}} и X-Application-Key: {{application_key}} — извлечени от променливите на колекцията. Поставянето на токена за достъп на приложението и ключа на приложението в тези променливи удостоверява автентичността на всяко заявка наведнъж, без да се налага настройка за всяка заявка поотделно.
Колекцията „Fabrixa Postman“ актуализира ли се, когато API се промени?
Да — при всяко пускане на версия API се предоставя актуализирана колекция на същия постоянен URL адрес, така че при повторно импортиране се изтеглят най-новите крайни точки и примерни данни. За крайните точки се предвижда 12-месечен преходен период, а колекцията маркира остарелите заявки в описанието им, преди да възникнат проблеми.
Какво връща заявката GET /orders/{id}/fulfillments?
Тя извлича статуса на производството за всеки артикул от подадена поръчка, като обхваща етапи като печат, фиксиране, пране и шиене, като за всеки от тях се посочва статуса „в очакване“, „в процес“, „завършено“ или „отхвърлено“. Колекцията в Postman включва пример с реални данни, така че форматът на отговора може да бъде проверен, преди да бъде интегриран в системата.
Изтегли и стартирай
Вземете колекцията. Изпратете първото си запитване.
Импортирайте колекцията, въведете данните си за достъп до канала за продажби и изпратете първото си запитване за броени минути — не се изисква код за интеграция, за да започнете да разглеждате.