{"pageKey":"Developers","slug":"developers-api-integrations","locale":"ru","localeResolved":"ru","fallbackApplied":false,"version":"developers-api-integrations@2026-11-18T23:56:14.758Z","lastModified":null,"canonicalUrl":"https://www.merchandaise.com/ru/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"Документация по API товаров и интеграция OpenAPI | MerchandAise","description":"Изучите документацию по API MerchandAise и спецификации OpenAPI для индивидуальных товаров, встраивания сообщества, рабочих процессов поставщиков и корпоративной идентификации.","sections":[{"heading":"Выберите подключение, необходимое вашему проекту","paragraphs":["Используйте ссылки ниже, чтобы оценить конечные точки, форматы запросов и требования к авторизации. Публичные спецификации поддерживают планирование и создание клиентов; оперативный доступ зависит от API, аккаунта и среды.","Когда MerchandAise обрабатывает покупку, Hutter Products GmbH выступает продавцом по договору и Merchant of Record под брендом MerchandAise. Данные и контакты поставщика остаются конфиденциальными, кроме случаев обязательного раскрытия. Для производства по-прежнему необходимы утверждение цифрового макета, подтверждение производимости, обязательные технические проверки и согласование образцов, применимые к конкретному принятому заказу."]},{"heading":"API и поверхности интеграции","items":[{"title":"Документация API и OpenAPI","description":"Найдите справочник по API для вспомогательных инструментов и сеансов проектирования, а затем выберите контракт сообщества, поставщика или предприятия для своего рабочего процесса. Руководство по внедрению: Прочтите документацию по инструментам помощника (/api/docs). Машинный контракт: Помощник по инструментам OpenAPI JSON (/api/docs/openapi.json). Доступ: Общественный. Публичный справочник по API-интерфейсам помощников и инструментов. Доступ к производству и операции, влияющие на заказы, по-прежнему требуют соответствующего разрешения. Каноническая страница: /ru/developers/api-integrations. Канонический раздел: /ru/developers/api-integrations#api-docs."},{"title":"API сообщества","description":"Подключите веб-сайт клуба или сообщества к общедоступной информации сообщества, представлению проектов, голосованию и передаче заказов. Что включает в себя договор: Контекст публичного сообщества, дизайн публикаций и голосований, публикация списков, ожидающие заказы, а также одобрение или отклонение владельца сообщества. Практическая отправная точка: Прочтите контекст публичного сообщества на веб-сайте клуба. Затем определите, какие действия требуют сеанса участника или разрешений владельца, прежде чем добавлять отправку проектов или передачу оформления заказа. Доступ: Спецификация общедоступна. Публичное чтение, действия участников и операции только для владельцев имеют разные требования к авторизации; используйте правила безопасности на каждой конечной точке. Руководство по внедрению: Изучите 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."},{"title":"API поставщика","description":"Подключите утвержденные системы поставщиков к выпущенным производственным пакетам, статусу адаптации и рабочим процессам веб-перехватчика 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."},{"title":"API корпоративного удостоверения","description":"Подключите утвержденные рабочие пространства компании к системе единого входа, подготовке пользователей и групп и записям аудита личности. Что включает в себя договор: Единый вход 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."}]},{"heading":"Выберите контракт перед кодом","items":[{"title":"Шаг 1: Составьте карту пути пользователя","description":"Решите, кто и где входит в рабочий процесс: покупатель во встроенной витрине, утвержденный поставщик, корпоративный пользователь или помощник, работающий с явным разрешением."},{"title":"Шаг 2: Подтвердите границу доступа","description":"Используйте общедоступные контракты для оценки и создания клиентов, а затем подтвердите учетные данные, области действия, среды, обратные вызовы и защищенные конечные точки перед внедрением."},{"title":"Шаг 3: Докажите непрерывность государства","description":"Проверьте, что проекты, предложения, утверждения, ошибки и передача заказов остаются актуальными на протяжении всей интеграции, включая повторные попытки и пути отката."}]},{"heading":"Что должна сохранять каждая интеграция","items":[{"title":"Одно версионное состояние","description":"Проектирование, коммерческое намерение, предложение поставщика, утверждение и статус заказа остаются на связи. Устаревшие изменения должны вызывать видимое состояние повторного цитирования или проверки."},{"title":"Коммерческая конфиденциальность и конфиденциальность поставщиков","description":"MerchandAise остается продавцом, работающим с покупателем, и владельцем службы поддержки. Личности, контакты и внутренние данные поставщиков не раскрываются посредством общедоступных интеграций."},{"title":"Одобрение перед производством","description":"3D-изображение не подтверждает физические свойства изделия. Подтверждённое ценовое предложение объясняет доступные варианты образцов для клиента, их стоимость, ограничения и сроки. До массового производства согласуйте точный цифровой макет и пройдите обязательные технические проверки, а также все необходимые или выбранные согласования образцов. Требования уже принятых заказов остаются обязательными."}]},{"heading":"До производственного трафика","paragraphs":["Опубликованный файл OpenAPI — это поверхность для планирования, а не гарантия анонимного доступа к рабочей среде. Перед запуском в эксплуатацию мы проверяем среды, учетные данные, обработку сбоев и оперативное владение."],"items":[{"title":"Доступ и среда","description":"Подтвердите версию контракта, утвержденное рабочее пространство, области аутентификации, песочницу, производственные учетные данные и места назначения обратного вызова."},{"title":"Неудача и восстановление","description":"Определите повторные попытки, идемпотентность, тайм-ауты, видимые для клиента ошибки, наблюдаемость, владение поддержкой и откат перед выпуском."},{"title":"Сквозные доказательства","description":"Проверьте предполагаемый путь в стадии от входа и изменения состояния до предложения, утверждения, передачи обслуживания и поведения восстановления."}]},{"heading":"Часто задаваемые вопросы","items":[{"title":"С какого API товаров мне следует начать?","description":"Начните с перехода человека и состояния. Используйте вставки сообщества для встреч с покупателями в клубах или сообществах, операции с поставщиками для утвержденных рабочих процессов на стороне предложения, корпоративную идентификацию для SSO и SCIM, а также вспомогательные инструменты только для явно разрешенных потоков под руководством ИИ."},{"title":"Означает ли государственный контракт доступ к государственному производству?","description":"Нет. Публичный контракт OpenAPI поддерживает обнаружение, проверку архитектуры и создание клиентов. Производственные учетные данные, операции записи, рабочие процессы поставщиков, корпоративная идентификация и выполнение помощника по-прежнему могут требовать утвержденного рабочего пространства и авторизации с ограниченной областью действия."},{"title":"Может ли интеграция раскрыть поставщиков или обойти одобрения?","description":"Нет. Личность и контактные данные поставщика остаются конфиденциальными, за исключением случаев, когда требуется раскрытие информации, отношения с покупателем принадлежат MerchandAise, а действия, влияющие на заказ, должны сохранять настроенные требования к цифровому макету, технические требования и требования к утверждению образца для конкретного заказа."}]},{"heading":"Планируйте свою интеграцию с нами.","paragraphs":["Расскажите нам, кто будет использовать интеграцию, какое состояние им нужно прочитать или изменить и где будет храниться этот опыт. Мы вместе с вами составим контракт, модель доступа и самый безопасный путь развертывания."],"items":[{"title":"Планируйте интеграцию","description":"/ru/contact?intent=api-integration-review"},{"title":"Изучите AI-агенты и MCP","description":"/ru/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"route-owned-source","schema":"2025-11-05"}}