Платформа за разработчици на MerchandAise

Единен работен процес за продуктите. Четири начина за свързване.

Свържете уебсайт, общност, операции на доставчици или корпоративно работно пространство към една и съща версионирана информация за дизайн, оферта, одобрение и състояние на поръчката. Започнете с публикувания договор, след което планирайте достъпа и внедряването в реална среда заедно с нас.

Поддържайте единен източник на истина

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

Когато MerchandAise обработва трансакцията на купувача, Hutter Products GmbH е продавачът по договор и регистрираният търговец (Merchant of Record) под марката MerchandAise. Идентичността и данните за контакт на доставчиците остават поверителни, освен в случаите, когато се изисква разкриване, а производството все още изисква одобрение на дигитална мостра и реална производствена мостра.

01 — Договори

Интерфейси за API и интеграция

Документация за API за инструменти за асистенти

Разгледайте текущите крайни точки за асистенти и инструменти за сесии за дизайн и преглед на интеграцията. Тази публична справка не предоставя анонимни права за изготвяне на оферти или генериране на поръчки.

Достъп: public

Ръководство за внедряване

Отворете документацията за инструменти за асистенти

Машинен договор

OpenAPI JSON за инструменти за асистенти

/api/docs/openapi.json

Публична справка за API за асистенти и инструменти. Достъпът до реална среда и операциите, засягащи поръчките, все още изискват съответната оторизация.

API за вграждане в общности

Свържете локализирани преживявания за клубове, общности или витрини на магазини към процесите за прехвърляне на дизайн и търговия, управлявани от MerchandAise, без да изграждате наново основния работен процес.

Достъп: public

Машинен договор

OpenAPI JSON за общности

/api/v1/community/public/openapi/v1

Публичен версиониран договор за вграждане на витрини, откриване на общности и прехвърляне на данни с отчитане на локализацията.

API за доставчици

Свържете одобрени доставчици с операции по въвеждане, каталог, оферти и изпълнение на поръчки, след като връзката с доставчика и моделът на достъп бъдат квалифицирани.

Достъп: public

Машинен договор

OpenAPI JSON за доставчици

/api/v1/supplier/openapi/v1

Публичен договор за планиране и генериране на клиенти. Оперативният достъп за доставчици остава обект на изрични разрешения.

API за корпоративна идентичност

Планирайте SSO, SCIM осигуряване (provisioning) и готови за одит потоци на идентичност за одобрени фирмени програми за мърчандайз и контролирани внедрявания.

Достъп: protected

Машинен договор

OpenAPI JSON за корпоративна идентичност

/api/v1/enterprise/identity/openapi/v1

Защитен договор за одобрени корпоративни работни пространства; заявете достъп, преди да използвате тази крайна точка.

02 — Ръководство за внедряване

Изберете договора преди кода

01
Картографирайте потребителския път
Решете кой влиза в работния процес и откъде: купувач във вградена витрина, одобрен доставчик, корпоративен потребител или асистент, работещ с изрична оторизация.
02
Потвърдете границата на достъп
Използвайте публични договори за оценка и генериране на клиенти, след което потвърдете идентификационните данни, обхватите (scopes), средите, обратните повиквания (callbacks) и защитените крайни точки преди внедряването.
03
Докажете непрекъснатостта на състоянието
Тествайте дали дизайните, офертите, одобренията, грешките и прехвърлянията на поръчки запазват актуалността на версиите си в рамките на интеграцията, включително при опити за повторение и пътища за връщане назад (rollback).

03 — Какво трябва да запази всяка интеграция

Какво трябва да запази всяка интеграция

Единно версионирано състояние

Дизайнът, търговското намерение, офертата от доставчик, одобрението и статусът на поръчката остават свързани. Неактуалните промени трябва да задействат видимо повторно офериране или състояние на преглед.

Търговска поверителност и поверителност на доставчиците

MerchandAise остава търговецът, работещ с купувачите, и собственикът на поддръжката. Идентичността, контактите и вътрешните данни на доставчиците не се разкриват чрез публични интеграции.

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

Интегрираният 3D изглед на продукта и дигиталната мостра подпомагат вземането на решение, но те не заменят реалната производствена мостра, която се изисква преди масовото производство.

Преди пускане в реална среда

Публикуваният OpenAPI файл е инструмент за планиране, а не обещание за анонимен достъп до реалната среда. Преди пускане в експлоатация преглеждаме средите, идентификационните данни, обработката на грешки и оперативната отговорност.

Достъп и среди

Потвърдете версията на договора, одобреното работно пространство, обхватите на автентификация, тестовата среда (sandbox), производствените идентификационни данни и дестинациите за обратни повиквания.

Сривове и възстановяване

Дефинирайте опитите за повторение, идемпотентността, изтичането на времето (timeouts), видимите за клиентите грешки, възможностите за наблюдение (observability), отговорността за поддръжката и връщането назад преди пускането.

Доказателство от край до край

Проверете планирания потребителски път в тестовата среда (staging) – от влизането и промяната на състоянието до офертата, одобрението, прехвърлянето и поведението при възстановяване.

Често задавани въпроси

С кой интерфейс за интеграция трябва да започна?

Започнете с потребителя и прехода на състоянието. Използвайте вграждания в общности за потребителски пътища на клубове или общности, насочени към купувачите; операции за доставчици за одобрени работни процеси от страна на доставката; корпоративна идентичност за SSO и SCIM; и инструменти за асистенти само за изрично оторизирани процеси, управлявани от AI.

Означава ли публичният договор публичен достъп до реална среда?

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

Може ли интеграцията да разкрие доставчици или да заобиколи одобренията?

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

Представете ни работния процес, а не завършена архитектура.

Кажете ни кой ще използва интеграцията, кое състояние трябва да чете или променя и къде ще се намира потребителското преживяване. Ние ще картографираме договора, модела на достъп и най-безопасния път за внедряване заедно с вас.

Планиране на интеграция Разгледайте AI агенти и MCP

Единен работен процес за продуктите. Четири начина за свързване.

Поддържайте единен източник на истина

Изберете договора преди кода

Картографирайте потребителския път

Решете кой влиза в работния процес и откъде: купувач във вградена витрина, одобрен доставчик, корпоративен потребител или асистент, работещ с изрична оторизация.

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

Използвайте публични договори за оценка и генериране на клиенти, след което потвърдете идентификационните данни, обхватите (scopes), средите, обратните повиквания (callbacks) и защитените крайни точки преди внедряването.

Докажете непрекъснатостта на състоянието

Тествайте дали дизайните, офертите, одобренията, грешките и прехвърлянията на поръчки запазват актуалността на версиите си в рамките на интеграцията, включително при опити за повторение и пътища за връщане назад (rollback).

Какво трябва да запази всяка интеграция

Единно версионирано състояние

Търговска поверителност и поверителност на доставчиците

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

Преди пускане в реална среда

Често задавани въпроси

С кой интерфейс за интеграция трябва да започна?

Означава ли публичният договор публичен достъп до реална среда?

Може ли интеграцията да разкрие доставчици или да заобиколи одобренията?

Представете ни работния процес, а не завършена архитектура.