Платформа для разработчиков MerchandAise

Единый рабочий процесс. Четыре способа интеграции.

Подключайте веб-сайты, сообщества, системы поставщиков или корпоративные рабочие пространства к единой версионированной системе проектирования, расчета стоимости, согласования и заказа. Начните с открытого контракта, а затем согласуйте с нами параметры доступа и запуск в производство.

Единый источник правды

Интеграция должна расширять рабочий процесс MerchandAise, а не разветвлять его. Веб-сайты, встраиваемые модули, системы поставщиков, корпоративные интерфейсы и будущие интерфейсы ассистентов должны считывать и обновлять одну и ту же версионированную информацию о дизайне, коммерческих намерениях, расчете стоимости, согласовании и статусе заказа.

В случаях, когда MerchandAise обрабатывает транзакции покупателей, Hutter Products GmbH выступает в качестве контрагента-продавца и официального торгового посредника (Merchant of Record) под брендом MerchandAise. Данные и контакты поставщиков остаются конфиденциальными, за исключением случаев, когда их раскрытие требуется по закону, а для запуска производства по-прежнему необходимы цифровой макет и утверждение реального физического образца.

01 — Контракты

Интерфейсы API и интеграции

API для инструментов ассистентов

Изучите текущие эндпоинты ассистентов и инструментов для сессий проектирования и анализа интеграции. Этот публичный справочник не дает анонимных прав на расчет стоимости или размещение заказов.

Доступ: public

Руководство по внедрению

Открыть документацию инструментов ассистента

Машиночитаемый контракт

OpenAPI JSON инструментов ассистента

/api/docs/openapi.json

Публичный справочник по API ассистентов и инструментов. Для доступа к рабочей среде и операциям, влияющим на заказы, по-прежнему требуется соответствующая авторизация.

API для встраивания в сообщества

Подключайте локализованные клубы, сообщества или интернет-магазины к процессам проектирования и коммерческого оформления MerchandAise без необходимости перестраивать базовый рабочий процесс.

Доступ: public

Машиночитаемый контракт

OpenAPI JSON для сообществ

/api/v1/community/public/openapi/v1

Публичный версионированный контракт для встраивания интернет-магазинов, поиска сообществ и передачи данных с учетом локали.

API для поставщиков

Подключайте одобренных поставщиков к процессам онбординга, каталога, расчета стоимости и выполнения заказов после подтверждения статуса партнера и модели доступа.

Доступ: public

Машиночитаемый контракт

OpenAPI JSON для поставщиков

/api/v1/supplier/openapi/v1

Публичный контракт для планирования и генерации клиентов. Операционный доступ для поставщиков предоставляется строго по разрешениям.

API корпоративной идентификации

Планируйте SSO, подготовку пользователей через SCIM и готовые к аудиту потоки идентификации для утвержденных корпоративных программ мерча и контролируемых запусков.

Доступ: protected

Машиночитаемый контракт

OpenAPI JSON корпоративной идентификации

/api/v1/enterprise/identity/openapi/v1

Защищенный контракт для утвержденных корпоративных рабочих пространств; запросите доступ перед использованием этого эндпоинта.

02 — Руководство по внедрению

Сначала выберите контракт, затем пишите код

01
Определите путь пользователя
Решите, кто и на каком этапе входит в рабочий процесс: покупатель во встроенном магазине, одобренный поставщик, корпоративный пользователь или ассистент, действующий на основании явного разрешения.
02
Подтвердите границы доступа
Используйте публичные контракты для оценки и генерации клиентов, а затем подтвердите учетные данные, области доступа (scopes), среды, обратные вызовы (callbacks) и защищенные эндпоинты перед началом разработки.
03
Обеспечьте непрерывность состояний
Убедитесь, что дизайн, расчет стоимости, согласования, ошибки и передача заказов сохраняют актуальность версий во всей интеграции, включая сценарии повторных попыток и отката.

03 — Что должна сохранять каждая интеграция

Что должна сохранять каждая интеграция

Единое версионированное состояние

Дизайн, коммерческие намерения, расчет стоимости от поставщика, согласование и статус заказа остаются взаимосвязанными. Устаревшие изменения должны приводить к заметному перерасчету стоимости или переходу в режим проверки.

Коммерческая конфиденциальность и приватность поставщиков

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

Согласование перед производством

Встроенный 3D-просмотр продукта и цифровой макет помогают принять решение, но они не заменяют реальный физический образец, необходимый перед запуском массового производства.

Перед запуском рабочего трафика

Опубликованный файл OpenAPI — это инструмент планирования, а не гарантия анонимного доступа к рабочей среде. Перед запуском мы проверяем среды, учетные данные, обработку сбоев и зоны операционной ответственности.

Доступ и среды

Подтвердите версию контракта, одобренное рабочее пространство, области аутентификации, песочницу, рабочие учетные данные и адреса обратных вызовов.

Сбои и восстановление

Определите правила повторных попыток, идемпотентность, таймауты, видимые пользователю ошибки, средства мониторинга, зоны ответственности поддержки и сценарии отката перед релизом.

Сквозное тестирование

Проверьте целевой сценарий в тестовой среде: от входа и изменения состояния до расчета стоимости, согласования, передачи данных и восстановления после сбоев.

FAQ

С какого интерфейса интеграции мне начать?

Начните с пользователя и переходов состояний. Используйте встраивание для сообществ для сценариев покупателей в клубах или сообществах, операции поставщиков — для утвержденных рабочих процессов на стороне снабжения, корпоративную идентификацию — для SSO и SCIM, а инструменты ассистентов — исключительно для авторизованных процессов под управлением AI.

Означает ли публичный контракт открытый доступ к рабочей среде?

Нет. Публичный контракт OpenAPI предназначен для ознакомления, анализа архитектуры и генерации клиентов. Для рабочих учетных данных, операций записи, рабочих процессов поставщиков, корпоративной идентификации и выполнения задач ассистентами по-прежнему может требоваться одобренное рабочее пространство и авторизация с ограниченными правами доступа.

Может ли интеграция раскрыть данные поставщиков или обойти этапы согласования?

Нет. Данные и контакты поставщиков остаются конфиденциальными, за исключением случаев, когда раскрытие требуется по закону. MerchandAise полностью контролирует взаимодействие с покупателями, а любые действия, влияющие на заказ, должны проходить через настроенные этапы согласования и утверждения физического образца.

Покажите нам рабочий процесс, а не готовую архитектуру.

Расскажите, кто будет использовать интеграцию, какое состояние им нужно считывать или изменять и где именно она будет работать. Мы вместе подберем контракт, модель доступа и наиболее безопасный путь развертывания.

Запланировать интеграцию Изучить AI-агентов и MCP

Единый рабочий процесс. Четыре способа интеграции.

Единый источник правды

Сначала выберите контракт, затем пишите код

Определите путь пользователя

Решите, кто и на каком этапе входит в рабочий процесс: покупатель во встроенном магазине, одобренный поставщик, корпоративный пользователь или ассистент, действующий на основании явного разрешения.

Подтвердите границы доступа

Используйте публичные контракты для оценки и генерации клиентов, а затем подтвердите учетные данные, области доступа (scopes), среды, обратные вызовы (callbacks) и защищенные эндпоинты перед началом разработки.

Обеспечьте непрерывность состояний

Убедитесь, что дизайн, расчет стоимости, согласования, ошибки и передача заказов сохраняют актуальность версий во всей интеграции, включая сценарии повторных попыток и отката.

Что должна сохранять каждая интеграция

Единое версионированное состояние

Коммерческая конфиденциальность и приватность поставщиков

Согласование перед производством

Перед запуском рабочего трафика

FAQ

С какого интерфейса интеграции мне начать?

Означает ли публичный контракт открытый доступ к рабочей среде?

Может ли интеграция раскрыть данные поставщиков или обойти этапы согласования?

Покажите нам рабочий процесс, а не готовую архитектуру.