Платформа за разработчици на MerchandAise
Единен работен процес за продуктите. Четири начина за свързване.
Свържете уебсайт, общност, операции на доставчици или корпоративно работно пространство към една и съща версионирана информация за дизайн, оферта, одобрение и състояние на поръчката. Започнете с публикувания договор, след което планирайте достъпа и внедряването в реална среда заедно с нас.
Поддържайте единен източник на истина
Интеграцията трябва да разширява работния процес на MerchandAise, а не да го разклонява. Уебсайтовете, вградените модули, интерфейсите за доставчици, корпоративните системи и бъдещите асистенти трябва да четат и актуализират една и съща версионирана информация за дизайн, търговско намерение, оферта, одобрение и състояние на поръчката.
Where MerchandAise processes the buyer transaction, Hutter Products GmbH is the contracting seller and Merchant of Record under the MerchandAise brand. Supplier identity and contact details stay private except where disclosure is required, and production still requires digital-proof approval, confirmed producibility, mandatory technical checks, and the sample approvals applicable to the exact accepted order.
01 — Договори
Интерфейси за API и интеграция
01
Документация за API за инструменти за асистенти
Разгледайте текущите крайни точки за асистенти и инструменти за сесии за дизайн и преглед на интеграцията. Тази публична справка не предоставя анонимни права за изготвяне на оферти или генериране на поръчки.
Ръководство за внедряване
Отворете документацията за инструменти за асистентиМашинен договор
OpenAPI JSON за инструменти за асистенти/api/docs/openapi.jsonПублична справка за API за асистенти и инструменти. Достъпът до реална среда и операциите, засягащи поръчките, все още изискват съответната оторизация.
02
API за вграждане в общности
Свържете локализирани преживявания за клубове, общности или витрини на магазини към процесите за прехвърляне на дизайн и търговия, управлявани от MerchandAise, без да изграждате наново основния работен процес.
Машинен договор
OpenAPI JSON за общности/api/v1/community/public/openapi/v1Публичен версиониран договор за вграждане на витрини, откриване на общности и прехвърляне на данни с отчитане на локализацията.
03
API за доставчици
Свържете одобрени доставчици с операции по въвеждане, каталог, оферти и изпълнение на поръчки, след като връзката с доставчика и моделът на достъп бъдат квалифицирани.
Машинен договор
OpenAPI JSON за доставчици/api/v1/supplier/openapi/v1Публичен договор за планиране и генериране на клиенти. Оперативният достъп за доставчици остава обект на изрични разрешения.
04
API за корпоративна идентичност
Планирайте SSO, SCIM осигуряване (provisioning) и готови за одит потоци на идентичност за одобрени фирмени програми за мърчандайз и контролирани внедрявания.
Машинен договор
OpenAPI JSON за корпоративна идентичност/api/v1/enterprise/identity/openapi/v1Защитен договор за одобрени корпоративни работни пространства; заявете достъп, преди да използвате тази крайна точка.
02 — Ръководство за внедряване
Изберете договора преди кода
- 01
Картографирайте потребителския път
Решете кой влиза в работния процес и откъде: купувач във вградена витрина, одобрен доставчик, корпоративен потребител или асистент, работещ с изрична оторизация.
- 02
Потвърдете границата на достъп
Използвайте публични договори за оценка и генериране на клиенти, след което потвърдете идентификационните данни, обхватите (scopes), средите, обратните повиквания (callbacks) и защитените крайни точки преди внедряването.
- 03
Докажете непрекъснатостта на състоянието
Тествайте дали дизайните, офертите, одобренията, грешките и прехвърлянията на поръчки запазват актуалността на версиите си в рамките на интеграцията, включително при опити за повторение и пътища за връщане назад (rollback).
03 — Какво трябва да запази всяка интеграция
Какво трябва да запази всяка интеграция
Единно версионирано състояние
Дизайнът, търговското намерение, офертата от доставчик, одобрението и статусът на поръчката остават свързани. Неактуалните промени трябва да задействат видимо повторно офериране или състояние на преглед.
Търговска поверителност и поверителност на доставчиците
MerchandAise остава търговецът, работещ с купувачите, и собственикът на поддръжката. Идентичността, контактите и вътрешните данни на доставчиците не се разкриват чрез публични интеграции.
Одобрение преди производство
A 3D view is not physical evidence. The confirmed quote explains any available customer-sample choices, costs, limitations, and timing. Approve the exact digital proof and complete mandatory technical checks and any required or selected sample approval before mass production. Existing accepted-order requirements remain binding.
04
Преди пускане в реална среда
Публикуваният OpenAPI файл е инструмент за планиране, а не обещание за анонимен достъп до реалната среда. Преди пускане в експлоатация преглеждаме средите, идентификационните данни, обработката на грешки и оперативната отговорност.
Достъп и среди
Потвърдете версията на договора, одобреното работно пространство, обхватите на автентификация, тестовата среда (sandbox), производствените идентификационни данни и дестинациите за обратни повиквания.
Сривове и възстановяване
Дефинирайте опитите за повторение, идемпотентността, изтичането на времето (timeouts), видимите за клиентите грешки, възможностите за наблюдение (observability), отговорността за поддръжката и връщането назад преди пускането.
Доказателство от край до край
Проверете планирания потребителски път в тестовата среда (staging) – от влизането и промяната на състоянието до офертата, одобрението, прехвърлянето и поведението при възстановяване.
Често задавани въпроси
С кой интерфейс за интеграция трябва да започна?
Започнете с потребителя и прехода на състоянието. Използвайте вграждания в общности за потребителски пътища на клубове или общности, насочени към купувачите; операции за доставчици за одобрени работни процеси от страна на доставката; корпоративна идентичност за SSO и SCIM; и инструменти за асистенти само за изрично оторизирани процеси, управлявани от AI.
Означава ли публичният договор публичен достъп до реална среда?
Не. Публичният OpenAPI договор подпомага проучването, прегледа на архитектурата и генерирането на клиенти. Производствените идентификационни данни, операциите за запис, работните процеси на доставчиците, корпоративната идентичност и изпълнението от асистенти все още могат да изискват одобрено работно пространство и ограничена по обхват оторизация.
Може ли интеграцията да разкрие доставчици или да заобиколи одобренията?
No. Supplier identity and contact details remain private except where disclosure is required, MerchandAise owns the buyer relationship, and order-affecting actions must preserve the configured digital-proof, technical, and order-specific sample approval requirements.
Представете ни работния процес, а не завършена архитектура.
Кажете ни кой ще използва интеграцията, кое състояние трябва да чете или променя и къде ще се намира потребителското преживяване. Ние ще картографираме договора, модела на достъп и най-безопасния път за внедряване заедно с вас.