# API документация и OpenAPI интеграции | MerchandAise

- slug: developers-api-integrations
- locale: bg
- localeResolved: bg
- canonical: https://www.merchandaise.com/bg/developers/api-integrations

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

## Изберете връзката, нужна на проекта ви
Използвайте справочниците по-долу, за да оцените крайните точки, форматите на заявките и изискванията за разрешение. Публичните спецификации подпомагат планирането и генерирането на клиенти; оперативният достъп зависи от API, акаунта и средата.
Когато MerchandAise обработва сделката с купувача, Hutter Products GmbH е договорният продавач и Merchant of Record под бранда MerchandAise. Самоличността и контактите на доставчика остават частни, освен при изисквано разкриване, а производството все пак изисква одобрение на дигиталния пробен преглед, потвърдена производимост, задължителни технически проверки и одобренията на мостри, приложими към точната приета поръчка.

## API и интерфейси за интеграция
- **API документация и OpenAPI:** Намерете API справочника за асистентски инструменти и дизайн сесии, след което изберете договора за общност, доставчик или компания според процеса си. Ръководство за внедряване: Прочетете документацията за асистентски инструменти (/api/docs). Машинночетим договор: OpenAPI JSON за асистентски инструменти (/api/docs/openapi.json). Достъп: Публичен. Публичен справочник за API на асистенти и инструменти. Достъпът до реалната среда и операциите, засягащи поръчки, все пак изискват приложимото разрешение. Канонична страница: /bg/developers/api-integrations. Каноничен раздел: /bg/developers/api-integrations#api-docs.
- **API за общности:** Свържете сайт на клуб или общност с публична информация за общността, предложения за дизайн, гласуване и предаване за одобрение на поръчки. Какво обхваща договорът: Публичен контекст на общността, публикации с дизайни и гласове, публикуване на обяви, чакащи поръчки и одобрение или отказ от собственика на общността. Практична отправна точка: Прочетете публичния контекст на общността за клубен сайт. След това определете кои действия изискват сесия на член или права на собственик, преди да добавите предложения за дизайн или преходи към плащане. Достъп: Спецификацията е публична. Публичното четене, действията на членове и операциите само за собственици имат различни изисквания за разрешение; използвайте правилата за сигурност на всяка крайна точка. Ръководство за внедряване: Разгледайте API за общности (/bg/developers/api-integrations#community-integrations). Машинночетим договор: OpenAPI JSON за общности (/api/v1/community/public/openapi/v1). Достъп: Публичен. Публичен версиониран договор за вградени магазини, откриване на общности и преходи със запазване на езика. Канонична страница: /bg/developers/api-integrations. Каноничен раздел: /bg/developers/api-integrations#community-integrations.
- **API за доставчици:** Свържете системите на одобрени доставчици с разрешени производствени пакети, статуса на приемане и webhook процеси за ERP или PLM. Какво обхваща договорът: Статус на приемане на доставчици, разрешени производствени пакети, одитирани изтегляния на ресурси, анализи, webhook абонаменти и контролни точки за синхронизация. Практична отправна точка: Планирайте връзка между вашата ERP или система за управление на жизнения цикъл на продукта и Центъра за доставчици. Прегледайте webhook данните, повторните опити и статуса на синхронизация, преди да обработвате възложена поръчка. Достъп: Прочетете OpenAPI спецификацията без вход. Оперативните заявки изискват подходящ акаунт за доставчик и права; публичната документация не регистрира доставчик и не предоставя достъп до данни на друг доставчик. Ръководство за внедряване: Разгледайте API за доставчици (/bg/developers/api-integrations#supplier-integrations). Машинночетим договор: OpenAPI JSON за доставчици (/api/v1/supplier/openapi/v1). Достъп: Публичен. Публичен договор за планиране и генериране на клиенти. Оперативният достъп за доставчици остава с разрешение. Канонична страница: /bg/developers/api-integrations. Каноничен раздел: /bg/developers/api-integrations#supplier-integrations.
- **API за фирмена идентичност:** Свържете одобрени фирмени работни пространства с единен вход, създаване на потребители и групи и одитни записи за идентичност. Какво обхваща договорът: Единен вход с OpenID Connect (OIDC), операции за жизнения цикъл на потребители и групи чрез SCIM, ротация на SCIM токени и одитни събития за създаване и поддръжка на акаунти. Практична отправна точка: Съпоставете доставчика си на идентичност с одобреното работно пространство. Планирайте входа, създаването и премахването на потребители, след което проверете съпоставянията на групи и одитните записи в договорената тестова среда. Достъп: Спецификацията за фирмена идентичност е защитена. Свържете се с екипа за интеграции, за да прегледате изискванията за работното пространство и достъпа преди внедряване. Фирмената идентичност е незадължителна за обичайни покупки на продукти. Ръководство за внедряване: Разгледайте фирмената идентичност (/bg/developers/api-integrations#enterprise-integrations). Машинночетим договор: OpenAPI JSON за фирмена идентичност (/api/v1/enterprise/identity/openapi/v1). Достъп: Защитен. Защитен договор за одобрени корпоративни работни пространства; поискайте достъп, преди да използвате тази крайна точка. Канонична страница: /bg/developers/api-integrations. Каноничен раздел: /bg/developers/api-integrations#enterprise-integrations.

## Изберете договора преди кода
- **Стъпка 1: Определете пътя на потребителя:** Решете кой влиза в процеса и откъде: купувач във вграден магазин, одобрен доставчик, корпоративен потребител или асистент, действащ с изрично разрешение.
- **Стъпка 2: Потвърдете границата на достъпа:** Използвайте публичните договори за оценка и генериране на клиенти, след което потвърдете идентификационните данни, правата, средите, обратните извиквания и защитените крайни точки преди внедряване.
- **Стъпка 3: Докажете непрекъснатостта на състоянието:** Тествайте дали дизайните, офертите, одобренията, грешките и предаването на поръчки остават актуални по версия в цялата интеграция, включително при повторни опити и връщане назад.

## Какво трябва да запазва всяка интеграция
- **Едно версионирано състояние:** Дизайнът, търговското намерение, потвърдената от доставчика оферта, одобрението и статусът на поръчката остават свързани. Остарелите промени трябва да водят до видима нова оферта или състояние на преглед.
- **Търговска поверителност и защита на доставчиците:** MerchandAise остава търговецът пред купувача и отговорната страна за поддръжката. Самоличността, контактите и вътрешните данни на доставчиците не се разкриват чрез публични интеграции.
- **Одобрение преди производство:** 3D прегледът не е физическо доказателство. Потвърдената оферта обяснява наличните възможности за клиентски мостри, разходите, ограниченията и сроковете. Преди серийното производство одобрете точния дигитален пробен преглед и завършете задължителните технически проверки и всички изисквани или избрани одобрения на мостри. Изискванията по вече приети поръчки остават задължителни.

## Преди реалния трафик
Публикуваният OpenAPI файл служи за планиране, а не обещава анонимен достъп до реалната среда. Преглеждаме средите, идентификационните данни, обработката на грешки и оперативната отговорност преди старта.
- **Достъп и среди:** Потвърдете версията на договора, одобреното работно пространство, правата за удостоверяване, тестовата среда, реалните идентификационни данни и дестинациите за обратни извиквания.
- **Грешки и възстановяване:** Определете повторните опити, идемпотентността, изчакванията, видимите за клиента грешки, наблюдаемостта, отговорността за поддръжка и връщането назад преди публикуване.
- **Доказателства за целия процес:** Проверете предвидения път в тестова среда от входа и промяната на състоянието до офертата, одобрението, предаването и възстановяването.

## Често задавани въпроси
- **С кой API за продукти да започна?:** Започнете с човека и промяната на състоянието. Използвайте вградени общности за клиентски пътища на клубове и общности, операции на доставчици за одобрени процеси от страната на доставките, фирмена идентичност за SSO и SCIM и асистентски инструменти само за изрично разрешени AI процеси.
- **Публичен договор означава ли публичен достъп до реалната среда?:** Не. Публичният OpenAPI договор подпомага откриването, архитектурния преглед и генерирането на клиенти. Реалните идентификационни данни, записващите операции, процесите на доставчици, фирмената идентичност и изпълнението от асистенти все пак може да изискват одобрено работно пространство и ограничено разрешение.
- **Може ли интеграцията да разкрие доставчици или да заобиколи одобрения?:** Не. Самоличността и контактите на доставчиците остават частни, освен при изисквано разкриване, MerchandAise управлява отношенията с купувача, а действията по поръчката трябва да запазват зададените изисквания за дигитален пробен преглед, технически проверки и одобрение на мостри за конкретната поръчка.

## Планирайте интеграцията си с нас.
Кажете ни кой ще използва интеграцията, кое състояние трябва да чете или променя и къде ще се използва. Заедно ще определим договора, модела на достъп и най-безопасния път за внедряване.
- **Планирайте интеграция:** /bg/contact?intent=api-integration-review
- **Разгледайте AI агенти и MCP:** /bg/developers/ai-agents-mcp
