MerchandAise платформа для разработчиков
Подключите свой рабочий процесс к MerchandAise.
Найдите документацию по API и спецификации OpenAPI для пользовательских рабочих процессов с товарами. Подключите веб-сайты, сообщества, операции поставщиков или учетные записи компаний к общей информации о дизайне, ценах и заказах.
Выберите подключение, необходимое вашему проекту
Используйте ссылки ниже, чтобы оценить конечные точки, форматы запросов и требования к авторизации. Публичные спецификации поддерживают планирование и создание клиентов; оперативный доступ зависит от API, аккаунта и среды.
Когда MerchandAise обрабатывает покупку, Hutter Products GmbH выступает продавцом по договору и Merchant of Record под брендом MerchandAise. Данные и контакты поставщика остаются конфиденциальными, кроме случаев обязательного раскрытия. Для производства по-прежнему необходимы утверждение цифрового макета, подтверждение производимости, обязательные технические проверки и согласование образцов, применимые к конкретному принятому заказу.
01 — Контракты
API и поверхности интеграции
01
Документация API и OpenAPI
Найдите справочник по API для вспомогательных инструментов и сеансов проектирования, а затем выберите контракт сообщества, поставщика или предприятия для своего рабочего процесса.
Руководство по внедрению
Прочтите документацию по инструментам помощникаМашинный контракт
Помощник по инструментам OpenAPI JSON/api/docs/openapi.jsonПубличный справочник по API-интерфейсам помощников и инструментов. Доступ к производству и операции, влияющие на заказы, по-прежнему требуют соответствующего разрешения.
02
API сообщества
Подключите веб-сайт клуба или сообщества к общедоступной информации сообщества, представлению проектов, голосованию и передаче заказов.
- Что включает в себя договор
- Контекст публичного сообщества, дизайн публикаций и голосований, публикация списков, ожидающие заказы, а также одобрение или отклонение владельца сообщества.
- Практическая отправная точка
- Прочтите контекст публичного сообщества на веб-сайте клуба. Затем определите, какие действия требуют сеанса участника или разрешений владельца, прежде чем добавлять отправку проектов или передачу оформления заказа.
- Доступ
- Спецификация общедоступна. Публичное чтение, действия участников и операции только для владельцев имеют разные требования к авторизации; используйте правила безопасности на каждой конечной точке.
Машинный контракт
Сообщество OpenAPI JSON/api/v1/community/public/openapi/v1Контракт с общедоступной версией для встраивания в витрину, открытия сообщества и передачи управления с учетом локали.
03
API поставщика
Подключите утвержденные системы поставщиков к выпущенным производственным пакетам, статусу адаптации и рабочим процессам веб-перехватчика ERP или PLM.
- Что включает в себя договор
- Состояние подключения поставщиков, выпущенные производственные пакеты, проверенные загрузки артефактов, аналитика, подписки на веб-перехватчики и контрольные точки синхронизации.
- Практическая отправная точка
- Запланируйте соединение между вашей ERP-системой или системой управления жизненным циклом продукта и Центром поставщиков. Прежде чем обрабатывать назначенный заказ, просмотрите полезные данные веб-перехватчика, повторные попытки и состояние синхронизации.
- Доступ
- Прочтите спецификацию OpenAPI, не входя в систему. Для операционных запросов требуется соответствующая учетная запись поставщика и разрешения; Публичная документация не регистрирует поставщика и не предоставляет доступ к данным другого поставщика.
Машинный контракт
Поставщик OpenAPI JSON/api/v1/supplier/openapi/v1Государственный контракт на планирование и привлечение клиентов. Оперативный доступ поставщиков остается разрешенным.
04
API корпоративного удостоверения
Подключите утвержденные рабочие пространства компании к системе единого входа, подготовке пользователей и групп и записям аудита личности.
- Что включает в себя договор
- Единый вход OpenID Connect (OIDC), операции жизненного цикла пользователей и групп SCIM, ротация токенов SCIM и подготовка событий аудита.
- Практическая отправная точка
- Сопоставьте своего поставщика удостоверений с утвержденной рабочей областью. Запланируйте вход, подготовку и отмену подготовки пользователей, а затем проверьте сопоставления групп и записи аудита в согласованной тестовой среде.
- Доступ
- Спецификация корпоративного удостоверения защищена. Свяжитесь с командой по интеграции, чтобы просмотреть рабочее пространство и требования к доступу перед внедрением. Корпоративный идентификатор не является обязательным для обычных покупок продуктов.
Машинный контракт
Корпоративный идентификатор OpenAPI JSON/api/v1/enterprise/identity/openapi/v1Защищенный контракт для утвержденных рабочих пространств предприятия; запросите доступ перед использованием этой конечной точки.
Планируйте интеграцию02 — Руководство по внедрению
Выберите контракт перед кодом
- 01
Составьте карту пути пользователя
Решите, кто и где входит в рабочий процесс: покупатель во встроенной витрине, утвержденный поставщик, корпоративный пользователь или помощник, работающий с явным разрешением.
- 02
Подтвердите границу доступа
Используйте общедоступные контракты для оценки и создания клиентов, а затем подтвердите учетные данные, области действия, среды, обратные вызовы и защищенные конечные точки перед внедрением.
- 03
Докажите непрерывность государства
Проверьте, что проекты, предложения, утверждения, ошибки и передача заказов остаются актуальными на протяжении всей интеграции, включая повторные попытки и пути отката.
03 — Что должна сохранять каждая интеграция
Что должна сохранять каждая интеграция
Одно версионное состояние
Проектирование, коммерческое намерение, предложение поставщика, утверждение и статус заказа остаются на связи. Устаревшие изменения должны вызывать видимое состояние повторного цитирования или проверки.
Коммерческая конфиденциальность и конфиденциальность поставщиков
MerchandAise остается продавцом, работающим с покупателем, и владельцем службы поддержки. Личности, контакты и внутренние данные поставщиков не раскрываются посредством общедоступных интеграций.
Одобрение перед производством
3D-изображение не подтверждает физические свойства изделия. Подтверждённое ценовое предложение объясняет доступные варианты образцов для клиента, их стоимость, ограничения и сроки. До массового производства согласуйте точный цифровой макет и пройдите обязательные технические проверки, а также все необходимые или выбранные согласования образцов. Требования уже принятых заказов остаются обязательными.
04
До производственного трафика
Опубликованный файл OpenAPI — это поверхность для планирования, а не гарантия анонимного доступа к рабочей среде. Перед запуском в эксплуатацию мы проверяем среды, учетные данные, обработку сбоев и оперативное владение.
Доступ и среда
Подтвердите версию контракта, утвержденное рабочее пространство, области аутентификации, песочницу, производственные учетные данные и места назначения обратного вызова.
Неудача и восстановление
Определите повторные попытки, идемпотентность, тайм-ауты, видимые для клиента ошибки, наблюдаемость, владение поддержкой и откат перед выпуском.
Сквозные доказательства
Проверьте предполагаемый путь в стадии от входа и изменения состояния до предложения, утверждения, передачи обслуживания и поведения восстановления.
Часто задаваемые вопросы
С какого API товаров мне следует начать?
Начните с перехода человека и состояния. Используйте вставки сообщества для встреч с покупателями в клубах или сообществах, операции с поставщиками для утвержденных рабочих процессов на стороне предложения, корпоративную идентификацию для SSO и SCIM, а также вспомогательные инструменты только для явно разрешенных потоков под руководством ИИ.
Означает ли государственный контракт доступ к государственному производству?
Нет. Публичный контракт OpenAPI поддерживает обнаружение, проверку архитектуры и создание клиентов. Производственные учетные данные, операции записи, рабочие процессы поставщиков, корпоративная идентификация и выполнение помощника по-прежнему могут требовать утвержденного рабочего пространства и авторизации с ограниченной областью действия.
Может ли интеграция раскрыть поставщиков или обойти одобрения?
Нет. Личность и контактные данные поставщика остаются конфиденциальными, за исключением случаев, когда требуется раскрытие информации, отношения с покупателем принадлежат MerchandAise, а действия, влияющие на заказ, должны сохранять настроенные требования к цифровому макету, технические требования и требования к утверждению образца для конкретного заказа.
Планируйте свою интеграцию с нами.
Расскажите нам, кто будет использовать интеграцию, какое состояние им нужно прочитать или изменить и где будет храниться этот опыт. Мы вместе с вами составим контракт, модель доступа и самый безопасный путь развертывания.