Перейти к основному содержимому

MerchandAise платформа для разработчиков

Подключите свой рабочий процесс к MerchandAise.

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

Выберите подключение, необходимое вашему проекту

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

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

01 — Контракты

API и поверхности интеграции

01

Документация API и OpenAPI

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

Доступ: Общественный/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 — Руководство по внедрению

Выберите контракт перед кодом

  1. 01

    Составьте карту пути пользователя

    Решите, кто и где входит в рабочий процесс: покупатель во встроенной витрине, утвержденный поставщик, корпоративный пользователь или помощник, работающий с явным разрешением.

  2. 02

    Подтвердите границу доступа

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

  3. 03

    Докажите непрерывность государства

    Проверьте, что проекты, предложения, утверждения, ошибки и передача заказов остаются актуальными на протяжении всей интеграции, включая повторные попытки и пути отката.

03 — Что должна сохранять каждая интеграция

Что должна сохранять каждая интеграция

Одно версионное состояние

Проектирование, коммерческое намерение, предложение поставщика, утверждение и статус заказа остаются на связи. Устаревшие изменения должны вызывать видимое состояние повторного цитирования или проверки.

Коммерческая конфиденциальность и конфиденциальность поставщиков

MerchandAise остается продавцом, работающим с покупателем, и владельцем службы поддержки. Личности, контакты и внутренние данные поставщиков не раскрываются посредством общедоступных интеграций.

Одобрение перед производством

3D-изображение не подтверждает физические свойства изделия. Подтверждённое ценовое предложение объясняет доступные варианты образцов для клиента, их стоимость, ограничения и сроки. До массового производства согласуйте точный цифровой макет и пройдите обязательные технические проверки, а также все необходимые или выбранные согласования образцов. Требования уже принятых заказов остаются обязательными.

04

До производственного трафика

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

01

Доступ и среда

Подтвердите версию контракта, утвержденное рабочее пространство, области аутентификации, песочницу, производственные учетные данные и места назначения обратного вызова.

02

Неудача и восстановление

Определите повторные попытки, идемпотентность, тайм-ауты, видимые для клиента ошибки, наблюдаемость, владение поддержкой и откат перед выпуском.

03

Сквозные доказательства

Проверьте предполагаемый путь в стадии от входа и изменения состояния до предложения, утверждения, передачи обслуживания и поведения восстановления.

Часто задаваемые вопросы

С какого API товаров мне следует начать?

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

Означает ли государственный контракт доступ к государственному производству?

Нет. Публичный контракт OpenAPI поддерживает обнаружение, проверку архитектуры и создание клиентов. Производственные учетные данные, операции записи, рабочие процессы поставщиков, корпоративная идентификация и выполнение помощника по-прежнему могут требовать утвержденного рабочего пространства и авторизации с ограниченной областью действия.

Может ли интеграция раскрыть поставщиков или обойти одобрения?

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

Планируйте свою интеграцию с нами.

Расскажите нам, кто будет использовать интеграцию, какое состояние им нужно прочитать или изменить и где будет храниться этот опыт. Мы вместе с вами составим контракт, модель доступа и самый безопасный путь развертывания.