Платформа для разработчиков MerchandAise
Единый рабочий процесс. Четыре способа интеграции.
Подключайте веб-сайты, сообщества, системы поставщиков или корпоративные рабочие пространства к единой версионированной системе проектирования, расчета стоимости, согласования и заказа. Начните с открытого контракта, а затем согласуйте с нами параметры доступа и запуск в производство.
Единый источник правды
Интеграция должна расширять рабочий процесс MerchandAise, а не разветвлять его. Веб-сайты, встраиваемые модули, системы поставщиков, корпоративные интерфейсы и будущие интерфейсы ассистентов должны считывать и обновлять одну и ту же версионированную информацию о дизайне, коммерческих намерениях, расчете стоимости, согласовании и статусе заказа.
Where MerchandAise processes the buyer transaction, Hutter Products GmbH is the contracting seller and Merchant of Record under the MerchandAise brand. Supplier identity and contact details stay private except where disclosure is required, and production still requires digital-proof approval, confirmed producibility, mandatory technical checks, and the sample approvals applicable to the exact accepted order.
01 — Контракты
Интерфейсы API и интеграции
01
API для инструментов ассистентов
Изучите текущие эндпоинты ассистентов и инструментов для сессий проектирования и анализа интеграции. Этот публичный справочник не дает анонимных прав на расчет стоимости или размещение заказов.
Руководство по внедрению
Открыть документацию инструментов ассистентаМашиночитаемый контракт
OpenAPI JSON инструментов ассистента/api/docs/openapi.jsonПубличный справочник по API ассистентов и инструментов. Для доступа к рабочей среде и операциям, влияющим на заказы, по-прежнему требуется соответствующая авторизация.
02
API для встраивания в сообщества
Подключайте локализованные клубы, сообщества или интернет-магазины к процессам проектирования и коммерческого оформления MerchandAise без необходимости перестраивать базовый рабочий процесс.
Машиночитаемый контракт
OpenAPI JSON для сообществ/api/v1/community/public/openapi/v1Публичный версионированный контракт для встраивания интернет-магазинов, поиска сообществ и передачи данных с учетом локали.
03
API для поставщиков
Подключайте одобренных поставщиков к процессам онбординга, каталога, расчета стоимости и выполнения заказов после подтверждения статуса партнера и модели доступа.
Машиночитаемый контракт
OpenAPI JSON для поставщиков/api/v1/supplier/openapi/v1Публичный контракт для планирования и генерации клиентов. Операционный доступ для поставщиков предоставляется строго по разрешениям.
04
API корпоративной идентификации
Планируйте SSO, подготовку пользователей через SCIM и готовые к аудиту потоки идентификации для утвержденных корпоративных программ мерча и контролируемых запусков.
Машиночитаемый контракт
OpenAPI JSON корпоративной идентификации/api/v1/enterprise/identity/openapi/v1Защищенный контракт для утвержденных корпоративных рабочих пространств; запросите доступ перед использованием этого эндпоинта.
02 — Руководство по внедрению
Сначала выберите контракт, затем пишите код
- 01
Определите путь пользователя
Решите, кто и на каком этапе входит в рабочий процесс: покупатель во встроенном магазине, одобренный поставщик, корпоративный пользователь или ассистент, действующий на основании явного разрешения.
- 02
Подтвердите границы доступа
Используйте публичные контракты для оценки и генерации клиентов, а затем подтвердите учетные данные, области доступа (scopes), среды, обратные вызовы (callbacks) и защищенные эндпоинты перед началом разработки.
- 03
Обеспечьте непрерывность состояний
Убедитесь, что дизайн, расчет стоимости, согласования, ошибки и передача заказов сохраняют актуальность версий во всей интеграции, включая сценарии повторных попыток и отката.
03 — Что должна сохранять каждая интеграция
Что должна сохранять каждая интеграция
Единое версионированное состояние
Дизайн, коммерческие намерения, расчет стоимости от поставщика, согласование и статус заказа остаются взаимосвязанными. Устаревшие изменения должны приводить к заметному перерасчету стоимости или переходу в режим проверки.
Коммерческая конфиденциальность и приватность поставщиков
MerchandAise остается продавцом, работающим с покупателями, и владельцем службы поддержки. Данные поставщиков, их контакты и внутренняя информация не раскрываются через публичные интеграции.
Согласование перед производством
A 3D view is not physical evidence. The confirmed quote explains any available customer-sample choices, costs, limitations, and timing. Approve the exact digital proof and complete mandatory technical checks and any required or selected sample approval before mass production. Existing accepted-order requirements remain binding.
04
Перед запуском рабочего трафика
Опубликованный файл OpenAPI — это инструмент планирования, а не гарантия анонимного доступа к рабочей среде. Перед запуском мы проверяем среды, учетные данные, обработку сбоев и зоны операционной ответственности.
Доступ и среды
Подтвердите версию контракта, одобренное рабочее пространство, области аутентификации, песочницу, рабочие учетные данные и адреса обратных вызовов.
Сбои и восстановление
Определите правила повторных попыток, идемпотентность, таймауты, видимые пользователю ошибки, средства мониторинга, зоны ответственности поддержки и сценарии отката перед релизом.
Сквозное тестирование
Проверьте целевой сценарий в тестовой среде: от входа и изменения состояния до расчета стоимости, согласования, передачи данных и восстановления после сбоев.
FAQ
С какого интерфейса интеграции мне начать?
Начните с пользователя и переходов состояний. Используйте встраивание для сообществ для сценариев покупателей в клубах или сообществах, операции поставщиков — для утвержденных рабочих процессов на стороне снабжения, корпоративную идентификацию — для SSO и SCIM, а инструменты ассистентов — исключительно для авторизованных процессов под управлением AI.
Означает ли публичный контракт открытый доступ к рабочей среде?
Нет. Публичный контракт OpenAPI предназначен для ознакомления, анализа архитектуры и генерации клиентов. Для рабочих учетных данных, операций записи, рабочих процессов поставщиков, корпоративной идентификации и выполнения задач ассистентами по-прежнему может требоваться одобренное рабочее пространство и авторизация с ограниченными правами доступа.
Может ли интеграция раскрыть данные поставщиков или обойти этапы согласования?
No. Supplier identity and contact details remain private except where disclosure is required, MerchandAise owns the buyer relationship, and order-affecting actions must preserve the configured digital-proof, technical, and order-specific sample approval requirements.
Покажите нам рабочий процесс, а не готовую архитектуру.
Расскажите, кто будет использовать интеграцию, какое состояние им нужно считывать или изменять и где именно она будет работать. Мы вместе подберем контракт, модель доступа и наиболее безопасный путь развертывания.