# Документация по API товаров и интеграция OpenAPI | MerchandAise

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

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

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

## API и поверхности интеграции
- **Документация API и OpenAPI:** Найдите справочник по API для вспомогательных инструментов и сеансов проектирования, а затем выберите контракт сообщества, поставщика или предприятия для своего рабочего процесса. Руководство по внедрению: Прочтите документацию по инструментам помощника (/api/docs). Машинный контракт: Помощник по инструментам OpenAPI JSON (/api/docs/openapi.json). Доступ: Общественный. Публичный справочник по API-интерфейсам помощников и инструментов. Доступ к производству и операции, влияющие на заказы, по-прежнему требуют соответствующего разрешения. Каноническая страница: /ru/developers/api-integrations. Канонический раздел: /ru/developers/api-integrations#api-docs.
- **API сообщества:** Подключите веб-сайт клуба или сообщества к общедоступной информации сообщества, представлению проектов, голосованию и передаче заказов. Что включает в себя договор: Контекст публичного сообщества, дизайн публикаций и голосований, публикация списков, ожидающие заказы, а также одобрение или отклонение владельца сообщества. Практическая отправная точка: Прочтите контекст публичного сообщества на веб-сайте клуба. Затем определите, какие действия требуют сеанса участника или разрешений владельца, прежде чем добавлять отправку проектов или передачу оформления заказа. Доступ: Спецификация общедоступна. Публичное чтение, действия участников и операции только для владельцев имеют разные требования к авторизации; используйте правила безопасности на каждой конечной точке. Руководство по внедрению: Изучите API сообщества (/ru/developers/api-integrations#community-integrations). Машинный контракт: Сообщество OpenAPI JSON (/api/v1/community/public/openapi/v1). Доступ: Общественный. Контракт с общедоступной версией для встраивания в витрину, открытия сообщества и передачи управления с учетом локали. Каноническая страница: /ru/developers/api-integrations. Канонический раздел: /ru/developers/api-integrations#community-integrations.
- **API поставщика:** Подключите утвержденные системы поставщиков к выпущенным производственным пакетам, статусу адаптации и рабочим процессам веб-перехватчика ERP или PLM. Что включает в себя договор: Состояние подключения поставщиков, выпущенные производственные пакеты, проверенные загрузки артефактов, аналитика, подписки на веб-перехватчики и контрольные точки синхронизации. Практическая отправная точка: Запланируйте соединение между вашей ERP-системой или системой управления жизненным циклом продукта и Центром поставщиков. Прежде чем обрабатывать назначенный заказ, просмотрите полезные данные веб-перехватчика, повторные попытки и состояние синхронизации. Доступ: Прочтите спецификацию OpenAPI, не входя в систему. Для операционных запросов требуется соответствующая учетная запись поставщика и разрешения; Публичная документация не регистрирует поставщика и не предоставляет доступ к данным другого поставщика. Руководство по внедрению: Изучите API поставщика (/ru/developers/api-integrations#supplier-integrations). Машинный контракт: Поставщик OpenAPI JSON (/api/v1/supplier/openapi/v1). Доступ: Общественный. Государственный контракт на планирование и привлечение клиентов. Оперативный доступ поставщиков остается разрешенным. Каноническая страница: /ru/developers/api-integrations. Канонический раздел: /ru/developers/api-integrations#supplier-integrations.
- **API корпоративного удостоверения:** Подключите утвержденные рабочие пространства компании к системе единого входа, подготовке пользователей и групп и записям аудита личности. Что включает в себя договор: Единый вход OpenID Connect (OIDC), операции жизненного цикла пользователей и групп SCIM, ротация токенов SCIM и подготовка событий аудита. Практическая отправная точка: Сопоставьте своего поставщика удостоверений с утвержденной рабочей областью. Запланируйте вход, подготовку и отмену подготовки пользователей, а затем проверьте сопоставления групп и записи аудита в согласованной тестовой среде. Доступ: Спецификация корпоративного удостоверения защищена. Свяжитесь с командой по интеграции, чтобы просмотреть рабочее пространство и требования к доступу перед внедрением. Корпоративный идентификатор не является обязательным для обычных покупок продуктов. Руководство по внедрению: Изучите корпоративную идентичность (/ru/developers/api-integrations#enterprise-integrations). Машинный контракт: Корпоративный идентификатор OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Доступ: Защищено. Защищенный контракт для утвержденных рабочих пространств предприятия; запросите доступ перед использованием этой конечной точки. Каноническая страница: /ru/developers/api-integrations. Канонический раздел: /ru/developers/api-integrations#enterprise-integrations.

## Выберите контракт перед кодом
- **Шаг 1: Составьте карту пути пользователя:** Решите, кто и где входит в рабочий процесс: покупатель во встроенной витрине, утвержденный поставщик, корпоративный пользователь или помощник, работающий с явным разрешением.
- **Шаг 2: Подтвердите границу доступа:** Используйте общедоступные контракты для оценки и создания клиентов, а затем подтвердите учетные данные, области действия, среды, обратные вызовы и защищенные конечные точки перед внедрением.
- **Шаг 3: Докажите непрерывность государства:** Проверьте, что проекты, предложения, утверждения, ошибки и передача заказов остаются актуальными на протяжении всей интеграции, включая повторные попытки и пути отката.

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

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

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

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