# Мерчандайз API та інтеграційні контракти | MerchandAise

- slug: developers-api-integrations
- locale: uk
- localeResolved: uk
- canonical: https://www.merchandaise.com/uk/developers/api-integrations

Ознайомтеся з контрактами MerchandAise для інструментів асистентів, вбудовування у спільноти, операцій постачальників та корпоративної ідентифікації з чіткими межами публічного й захищеного доступу.

## Зберігайте єдине джерело правди
Інтеграція має розширювати робочий процес MerchandAise , а не дублювати його. Вебсайт, вбудований компонент, постачальник, корпоративна система та майбутні інтерфейси асистентів повинні зчитувати й оновлювати однаковий версіонований стан дизайну, комерційного наміру, розрахунку ціни, затвердження та замовлення.
Там, де MerchandAise обробляє транзакцію покупця, Hutter Products GmbH виступає продавцем за контрактом і торговим посередником (Merchant of Record) під брендом MerchandAise . Ідентифікаційні дані та контакти постачальників залишаються конфіденційними, окрім випадків, коли вимагається їх розкриття, а для виробництва все одно потрібне схвалення цифрового макета й справжнього зразка.

## Інтерфейси API та інтеграції
- **Документація інструментів асистентів API:** Ознайомтеся з поточними кінцевими точками (endpoints) асистентів та інструментів для сесій дизайну й перевірки інтеграції. Ця публічна довідкова інформація не надає анонімних прав на розрахунок ціни чи оформлення замовлення. Human guide: Відкрити документацію інструментів асистентів (/uk/developers/api-integrations). Machine-readable contract: Інструменти асистентів OpenAPI JSON (/api/docs/openapi.json). Access: public. Публічна довідка для асистентів та інструментів API . Доступ до виробничого середовища та операції, що впливають на замовлення, все одно вимагають відповідної авторизації. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs.
- **Вбудовування для спільнот API:** Підключайте локалізовані клуби, спільноти чи вітрини до процесів дизайну та комерційної передачі від MerchandAise без необхідності перебудови базового робочого процесу. Human guide: Переглянути посібник з інтеграції для спільнот (/uk/developers/api-integrations#community-integrations). Machine-readable contract: Спільнота OpenAPI JSON (/api/v1/community/public/openapi/v1). Access: public. Публічний версіонований контракт для вбудовування вітрин, пошуку спільнот та передачі даних із урахуванням локалі. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations.
- **API постачальника:** Підключайте затверджених постачальників до процесів адаптації (onboarding), каталогів, розрахунку ціни та виконання замовлень після узгодження відносин із постачальником та моделі доступу. Human guide: Переглянути посібник з інтеграції постачальників (/uk/developers/api-integrations#supplier-integrations). Machine-readable contract: OpenAPI JSON постачальника (/api/v1/supplier/openapi/v1). Access: public. Публічний контракт для планування та генерації клієнтського коду. Операційний доступ постачальника залишається обмеженим за дозволами. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations.
- **Корпоративна ідентифікація API:** Плануйте SSO , процеси надання прав SCIM та готові до аудитів процедури ідентифікації для затверджених програм корпоративного мерчандайзу й контрольованих запусків. Human guide: Переглянути посібник з корпоративної інтеграції (/uk/developers/api-integrations#enterprise-integrations). Machine-readable contract: Корпоративна ідентифікація OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. Захищений контракт для затверджених корпоративних робочих просторів; надішліть запит на доступ перед використанням цієї кінцевої точки. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations.

## Оберіть контракт перед написанням коду
- **Step 1: Спроєктуйте шлях користувача:** Визначте, хто і де входить у робочий процес: покупець у вбудованій вітрині, затверджений постачальник, корпоративний користувач або асистент, що діє з явним дозволом.
- **Step 2: Підтвердьте межі доступу:** Використовуйте публічні контракти для оцінки та генерації клієнтського коду, а перед впровадженням підтвердьте облікові дані, області дії (scopes), середовища, зворотні виклики (callbacks) і захищені кінцеві точки.
- **Step 3: Доведіть неперервність стану:** Перевірте, чи дизайн, цінові пропозиції, затвердження, помилки та етапи передачі замовлень залишаються актуальних версій в інтеграції, враховуючи повторні спроби (retries) та шляхи відкату (rollback).

## Що має зберігати кожна інтеграція
- **Єдиний версіонований стан:** Дизайн, комерційний намір, цінова пропозиція від постачальника, статус затвердження та замовлення залишаються пов'язаними. Застарілі зміни повинні активувати видимий стан повторного розрахунку ціни або перевірки.
- **Комерційна конфіденційність і конфіденційність постачальників:** MerchandAise залишається продавцем, що взаємодіє з покупцем, і відповідає за підтримку. Ідентифікаційні дані постачальників, їхні контакти та внутрішні дані не розголошуються через публічні інтеграції.
- **Затвердження перед виробництвом:** Вбудований у продукт перегляд 3D та цифрові макети підтримують прийняття рішення, але вони не замінюють справжній виробничий зразок, який є обов'язковим перед початком масового виробництва.

## Перед запуском виробничого трафіку
Опублікований файл OpenAPI є планом для опрацювання, а не гарантією анонімного виробничого доступу. Перед виходом у продакшн ми перевіряємо середовища, облікові дані, обробку помилок та операційну відповідальність.
- **Доступ і середовища:** Підтвердьте версію контракту, затверджений робочий простір, області автентифікації, пісочницю (sandbox), виробничі облікові дані та адреси для зворотних викликів.
- **Збої та відновлення:** Визначте логіку повторних спроб, ідемпотентність, таймаути, видимі для клієнта помилки, спостережуваність (observability), відповідальність за підтримку та процедури відкату перед випуском.
- **Сквозні перевірки (end-to-end):** Перевірте запланований шлях у тестовому середовищі (staging) — від входу та зміни стану до розрахунку ціни, затвердження, передачі та поведінки системи під час відновлення.

## Часті питання
- **З якого інтеграційного інтерфейсу варто починати?:** Починайте з користувача та переходу стану. Використовуйте вбудовані компоненти спільнот для клубів або спільнот покупців, операції постачальників для затверджених робочих процесів постачання, корпоративну ідентифікацію для SSO та SCIM , а інструменти асистентів — виключно для процесів під керівництвом AI з явними повноваженнями.
- **Чи означає публічний контракт публічний доступ до виробництва?:** Ні. Публічний контракт OpenAPI підтримує пошук, перегляд архітектури та генерацію клієнтського коду. Виробничі облікові дані, операції запису, робочі процеси постачальників, корпоративна ідентифікація та виконання асистентів все одно можуть вимагати затвердженого робочого простору та авторизації з обмеженою областю дії.
- **Чи може інтеграція розкривати дані постачальників або обходити затвердження?:** Ні. Ідентифікаційні дані та контакти постачальників залишаються конфіденційними, окрім випадків, коли вимагається їх розкриття, MerchandAise володіє відносинами з покупцем, а дії, що впливають на замовлення, повинні дотримуватися налаштованих шлюзів затвердження та перевірки справжнього зразка.

## Надайте нам робочий процес, а не готову архітектуру.
Розкажіть нам, хто використовуватиме інтеграцію, який стан їм потрібно зчитувати чи змінювати та де розміщуватиметься інтерфейс. Ми допоможемо вам розробити контракт, модель доступу та найбезпечніший шлях розгортання.
- **Спланувати інтеграцію:** /uk/contact?intent=api-integration-review
- **Дослідити агентів AI та MCP:** /uk/developers/ai-agents-mcp