{"pageKey":"Developers","slug":"developers-api-integrations","locale":"uk","localeResolved":"uk","fallbackApplied":false,"version":"developers-api-integrations@2026-11-19T06:57:32.638Z","lastModified":null,"canonicalUrl":"https://www.merchandaise.com/uk/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"Документація Merchandise API та інтеграція OpenAPI | MerchandAise","description":"Ознайомтеся з документами API MerchandAise і специфікаціями OpenAPI для спеціальних товарів, вставок спільноти, робочих процесів постачальників і ідентифікації підприємства.","sections":[{"heading":"Виберіть підключення, яке потрібне вашому проекту","paragraphs":["Використовуйте наведені нижче посилання, щоб оцінити кінцеві точки, формати запитів і вимоги до авторизації. Загальнодоступні специфікації підтримують планування та створення клієнтів; операційний доступ залежить від API, облікового запису та середовища.","Якщо MerchandAise обробляє транзакцію покупця, Hutter Products GmbH є продавцем за контрактом і офіційним продавцем під брендом MerchandAise. Інформація про постачальника та контактні дані залишаються конфіденційними, за винятком випадків, коли потрібне розголошення, а виробництво все ще вимагає цифрового підтвердження, підтвердженої можливості виробництва, обов’язкових технічних перевірок і зразків схвалень, застосовних до точного прийнятого замовлення."]},{"heading":"API та інтеграційні поверхні","items":[{"title":"Документи API та OpenAPI","description":"Знайдіть довідник API для інструментів допоміжного користувача та сеансів проектування, а потім виберіть співтовариство, постачальника або корпоративний контракт для свого робочого процесу. Посібник із впровадження: Прочитайте документацію про інструменти помічника (/api/docs). Машинний договір: Помічник інструментів OpenAPI JSON (/api/docs/openapi.json). Доступ: Громадський. Загальнодоступна довідка для API помічників і інструментів. Доступ до виробництва та операції, що впливають на замовлення, все ще потребують відповідного авторизації. Канонічна сторінка: /uk/developers/api-integrations. Канонічний розділ: /uk/developers/api-integrations#api-docs."},{"title":"API спільноти","description":"Підключіть веб-сайт клубу чи спільноти до загальнодоступної інформації про спільноту, подання дизайну, голосування та передачі схвалення замовлення. Що охоплює договір: Загальнодоступний контекст спільноти, публікації дизайну та голосування, публікація списку, замовлення, що очікують на розгляд, а також схвалення або відхилення власником спільноти. Практична відправна точка: Прочитайте публічний контекст спільноти для веб-сайту клубу. Потім визначте, для яких дій потрібен сеанс учасника або дозволи власника, перш ніж додавати подання дизайну або перевірку. Доступ: Специфікація є публічною. Загальнодоступні читання, дії учасників і операції лише власника мають різні вимоги до авторизації; використовувати правила безпеки для кожної кінцевої точки. Посібник із впровадження: Дослідіть API спільноти (/uk/developers/api-integrations#community-integrations). Машинний договір: Спільнота OpenAPI JSON (/api/v1/community/public/openapi/v1). Доступ: Громадський. Контракт із загальнодоступною версією для вбудовування вітрини магазину, пошуку спільноти та передачі з урахуванням локалі. Канонічна сторінка: /uk/developers/api-integrations. Канонічний розділ: /uk/developers/api-integrations#community-integrations."},{"title":"API постачальника","description":"Підключіть схвалені системи постачальників до випущених виробничих пакетів, статусу реєстрації та робочих процесів ERP або PLM webhook. Що охоплює договір: Стан реєстрації постачальника, випущені робочі пакети, перевірені завантаження артефактів, аналітика, підписки на вебхук і контрольні точки синхронізації. Практична відправна точка: Сплануйте зв’язок між вашим ERP або системою керування життєвим циклом продукту та центром постачальників. Перегляньте корисне навантаження, повторні спроби та статус синхронізації вебхука перед обробкою призначеного замовлення. Доступ: Читайте специфікацію OpenAPI без входу. Операційні запити вимагають відповідного облікового запису постачальника та дозволів; публічна документація не реєструє постачальника та не надає доступу до даних іншого постачальника. Посібник із впровадження: Дослідіть Supplier API (/uk/developers/api-integrations#supplier-integrations). Машинний договір: Постачальник OpenAPI JSON (/api/v1/supplier/openapi/v1). Доступ: Громадський. Публічний договір на планування та генерацію клієнтів. Оперативний доступ постачальника залишається дозволеним. Канонічна сторінка: /uk/developers/api-integrations. Канонічний розділ: /uk/developers/api-integrations#supplier-integrations."},{"title":"Enterprise Identity API","description":"Підключіть схвалені робочі області компанії до системи єдиного входу, ініціалізації користувачів і груп і записів аудиту ідентифікації. Що охоплює договір: Єдиний вхід OpenID Connect (OIDC), операції життєвого циклу користувачів і груп SCIM, ротація маркерів SCIM і події аудиту надання. Практична відправна точка: Зіставте свого постачальника посвідчень із схваленою робочою областю. Сплануйте вхід, ініціалізацію та деініціалізацію користувача, а потім перевірте зіставлення груп і записи аудиту в узгодженому тестовому середовищі. Доступ: Специфікація корпоративної ідентифікації захищена. Перед впровадженням зв’яжіться з командою інтеграції, щоб перевірити робочий простір і вимоги до доступу. Ідентифікація підприємства є необов’язковою для звичайних покупок продуктів. Посібник із впровадження: Вивчіть ідентичність підприємства (/uk/developers/api-integrations#enterprise-integrations). Машинний договір: Корпоративна ідентифікація OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Доступ: Захищений. Захищений договір для затверджених робочих місць підприємства; запитувати доступ перед використанням цієї кінцевої точки. Канонічна сторінка: /uk/developers/api-integrations. Канонічний розділ: /uk/developers/api-integrations#enterprise-integrations."}]},{"heading":"Виберіть договір перед кодом","items":[{"title":"Крок 1: Карта шляху користувача","description":"Вирішіть, хто і де входить у робочий процес: покупець у вбудованій вітрині магазину, схвалений постачальник, корпоративний користувач або помічник, який працює з чітким дозволом."},{"title":"Крок 2: Підтвердьте межу доступу","description":"Використовуйте публічні контракти для оцінки та створення клієнтів, а потім підтверджуйте облікові дані, області дії, середовища, зворотні виклики та захищені кінцеві точки перед впровадженням."},{"title":"Крок 3: Доведіть безперервність стану","description":"Перевірте, чи дизайни, пропозиції, схвалення, помилки та передача замовлення залишаються поточними версіями протягом інтеграції, включаючи повторні спроби та шляхи відкату."}]},{"heading":"Те, що має зберегти кожна інтеграція","items":[{"title":"Одноверсійний стан","description":"Дизайн, намір придбати, цінова пропозиція з підтвердженням постачальника, погодження та статус замовлення залишаються пов’язаними. Зміни, через які дані застаріли, повинні запускати помітний запит на нову цінову пропозицію або повторний розгляд."},{"title":"Комерційна конфіденційність і конфіденційність постачальників","description":"MerchandAise залишається продавцем і власником служби підтримки, який підтримує покупців. Ідентифікаційні дані постачальників, контакти та внутрішні дані не розкриваються через публічну інтеграцію."},{"title":"Ухвалення перед виробництвом","description":"Тривимірне зображення не є речовим доказом. Підтверджена цінова пропозиція пояснює будь-який доступний вибір зразків клієнта, вартість, обмеження та терміни. Перед масовим виробництвом затвердьте точний цифровий макет і завершіть обов’язкові технічні перевірки та будь-які необхідні або вибрані зразки. Існуючі вимоги прийнятого замовлення залишаються обов’язковими."}]},{"heading":"Перед виробничим трафіком","paragraphs":["Опублікований файл OpenAPI — це поверхня для планування, а не обіцянка анонімного робочого доступу. Перед запуском ми перевіряємо середовища, облікові дані, усунення збоїв і операційну власність."],"items":[{"title":"Доступ і середовища","description":"Підтвердьте версію контракту, схвалену робочу область, області автентифікації, ізольоване програмне середовище, робочі облікові дані та призначення зворотного виклику."},{"title":"Відмова і відновлення","description":"Визначте повторні спроби, ідемпотентність, тайм-аути, видимі клієнтом помилки, спостережливість, підтримку власності та відкат перед випуском."},{"title":"Наскрізні докази","description":"Перевірте заплановану подорож у етапі від входу та мутації стану через котирування, схвалення, передачу та поведінку відновлення."}]},{"heading":"FAQ","items":[{"title":"З якого API товарів мені почати?","description":"Почніть із переходу особи та стану. Використовуйте вбудовування спільноти для клубних або спільнотних поїздок, пов’язаних із покупцями, операцій постачальників для схвалених робочих процесів на стороні постачання, ідентифікації підприємства для SSO та SCIM, а також допоміжні інструменти лише для явно авторизованих потоків, керованих ШІ."},{"title":"Чи означає державний контракт доступ до публічного виробництва?","description":"Ні. Загальнодоступний контракт OpenAPI підтримує виявлення, перегляд архітектури та створення клієнта. Виробничі облікові дані, операції запису, робочі цикли постачальників, ідентифікаційні дані підприємства та виконання помічника все ще можуть вимагати схваленого робочого простору та авторизації в межах."},{"title":"Чи може інтеграція викрити постачальників або обійти схвалення?","description":"Ні. Інформація про постачальника та контактні дані залишаються конфіденційними, за винятком випадків, коли потрібне розголошення, MerchandAise володіє відносинами з покупцем, а дії, що впливають на замовлення, мають зберігати налаштовані цифрові макети, технічні вимоги та вимоги до затвердження зразків, що стосуються замовлення."}]},{"heading":"Плануйте свою інтеграцію з нами.","paragraphs":["Розкажіть нам, хто використовуватиме інтеграцію, який стан їм потрібно прочитати або змінити, і де буде зберігатися досвід. Ми разом з вами розглянемо договір, модель доступу та найбезпечніший шлях розгортання."],"items":[{"title":"Плануйте інтеграцію","description":"/uk/contact?intent=api-integration-review"},{"title":"Досліджуйте агентів ШІ та MCP","description":"/uk/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"route-owned-source","schema":"2025-11-05"}}