# API мерча и контракты интеграции | MerchandAise

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

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

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

## Интерфейсы API и интеграции
- **API для инструментов ассистентов:** Изучите текущие эндпоинты ассистентов и инструментов для сессий проектирования и анализа интеграции. Этот публичный справочник не дает анонимных прав на расчет стоимости или размещение заказов. Human guide: Открыть документацию инструментов ассистента (/ru/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: Изучить руководство по интеграции сообществ (/ru/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 для поставщиков:** Подключайте одобренных поставщиков к процессам онбординга, каталога, расчета стоимости и выполнения заказов после подтверждения статуса партнера и модели доступа. Human guide: Изучить руководство по интеграции поставщиков (/ru/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: Изучить руководство по корпоративной интеграции (/ru/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: Обеспечьте непрерывность состояний:** Убедитесь, что дизайн, расчет стоимости, согласования, ошибки и передача заказов сохраняют актуальность версий во всей интеграции, включая сценарии повторных попыток и отката.

## Что должна сохранять каждая интеграция
- **Единое версионированное состояние:** Дизайн, коммерческие намерения, расчет стоимости от поставщика, согласование и статус заказа остаются взаимосвязанными. Устаревшие изменения должны приводить к заметному перерасчету стоимости или переходу в режим проверки.
- **Коммерческая конфиденциальность и приватность поставщиков:** MerchandAise остается продавцом, работающим с покупателями, и владельцем службы поддержки. Данные поставщиков, их контакты и внутренняя информация не раскрываются через публичные интеграции.
- **Согласование перед производством:** Встроенный 3D-просмотр продукта и цифровой макет помогают принять решение, но они не заменяют реальный физический образец, необходимый перед запуском массового производства.

## Перед запуском рабочего трафика
Опубликованный файл OpenAPI — это инструмент планирования, а не гарантия анонимного доступа к рабочей среде. Перед запуском мы проверяем среды, учетные данные, обработку сбоев и зоны операционной ответственности.
- **Доступ и среды:** Подтвердите версию контракта, одобренное рабочее пространство, области аутентификации, песочницу, рабочие учетные данные и адреса обратных вызовов.
- **Сбои и восстановление:** Определите правила повторных попыток, идемпотентность, таймауты, видимые пользователю ошибки, средства мониторинга, зоны ответственности поддержки и сценарии отката перед релизом.
- **Сквозное тестирование:** Проверьте целевой сценарий в тестовой среде: от входа и изменения состояния до расчета стоимости, согласования, передачи данных и восстановления после сбоев.

## FAQ
- **С какого интерфейса интеграции мне начать?:** Начните с пользователя и переходов состояний. Используйте встраивание для сообществ для сценариев покупателей в клубах или сообществах, операции поставщиков — для утвержденных рабочих процессов на стороне снабжения, корпоративную идентификацию — для SSO и SCIM, а инструменты ассистентов — исключительно для авторизованных процессов под управлением AI.
- **Означает ли публичный контракт открытый доступ к рабочей среде?:** Нет. Публичный контракт OpenAPI предназначен для ознакомления, анализа архитектуры и генерации клиентов. Для рабочих учетных данных, операций записи, рабочих процессов поставщиков, корпоративной идентификации и выполнения задач ассистентами по-прежнему может требоваться одобренное рабочее пространство и авторизация с ограниченными правами доступа.
- **Может ли интеграция раскрыть данные поставщиков или обойти этапы согласования?:** Нет. Данные и контакты поставщиков остаются конфиденциальными, за исключением случаев, когда раскрытие требуется по закону. MerchandAise полностью контролирует взаимодействие с покупателями, а любые действия, влияющие на заказ, должны проходить через настроенные этапы согласования и утверждения физического образца.

## Покажите нам рабочий процесс, а не готовую архитектуру.
Расскажите, кто будет использовать интеграцию, какое состояние им нужно считывать или изменять и где именно она будет работать. Мы вместе подберем контракт, модель доступа и наиболее безопасный путь развертывания.
- **Запланировать интеграцию:** /ru/contact?intent=api-integration-review
- **Изучить AI-агентов и MCP:** /ru/developers/ai-agents-mcp