# Договори за API и интеграция на мърчандайз | MerchandAise

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

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

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

## Интерфейси за API и интеграция
- **Документация за API за инструменти за асистенти:** Разгледайте текущите крайни точки за асистенти и инструменти за сесии за дизайн и преглед на интеграцията. Тази публична справка не предоставя анонимни права за изготвяне на оферти или генериране на поръчки. Human guide: Отворете документацията за инструменти за асистенти (/bg/developers/api-integrations). Machine-readable contract: OpenAPI JSON за инструменти за асистенти (/api/docs/openapi.json). Access: public. Публична справка за API за асистенти и инструменти. Достъпът до реална среда и операциите, засягащи поръчките, все още изискват съответната оторизация. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs.
- **API за вграждане в общности:** Свържете локализирани преживявания за клубове, общности или витрини на магазини към процесите за прехвърляне на дизайн и търговия, управлявани от MerchandAise, без да изграждате наново основния работен процес. Human guide: Преглед на ръководството за интеграция в общности (/bg/developers/api-integrations#community-integrations). Machine-readable contract: OpenAPI JSON за общности (/api/v1/community/public/openapi/v1). Access: public. Публичен версиониран договор за вграждане на витрини, откриване на общности и прехвърляне на данни с отчитане на локализацията. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations.
- **API за доставчици:** Свържете одобрени доставчици с операции по въвеждане, каталог, оферти и изпълнение на поръчки, след като връзката с доставчика и моделът на достъп бъдат квалифицирани. Human guide: Преглед на ръководството за интеграция на доставчици (/bg/developers/api-integrations#supplier-integrations). Machine-readable contract: OpenAPI JSON за доставчици (/api/v1/supplier/openapi/v1). Access: public. Публичен договор за планиране и генериране на клиенти. Оперативният достъп за доставчици остава обект на изрични разрешения. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations.
- **API за корпоративна идентичност:** Планирайте SSO, SCIM осигуряване (provisioning) и готови за одит потоци на идентичност за одобрени фирмени програми за мърчандайз и контролирани внедрявания. Human guide: Преглед на ръководството за корпоративна интеграция (/bg/developers/api-integrations#enterprise-integrations). Machine-readable contract: OpenAPI JSON за корпоративна идентичност (/api/v1/enterprise/identity/openapi/v1). Access: protected. Защитен договор за одобрени корпоративни работни пространства; заявете достъп, преди да използвате тази крайна точка. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations.

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

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

## Преди пускане в реална среда
Публикуваният OpenAPI файл е инструмент за планиране, а не обещание за анонимен достъп до реалната среда. Преди пускане в експлоатация преглеждаме средите, идентификационните данни, обработката на грешки и оперативната отговорност.
- **Достъп и среди:** Потвърдете версията на договора, одобреното работно пространство, обхватите на автентификация, тестовата среда (sandbox), производствените идентификационни данни и дестинациите за обратни повиквания.
- **Сривове и възстановяване:** Дефинирайте опитите за повторение, идемпотентността, изтичането на времето (timeouts), видимите за клиентите грешки, възможностите за наблюдение (observability), отговорността за поддръжката и връщането назад преди пускането.
- **Доказателство от край до край:** Проверете планирания потребителски път в тестовата среда (staging) – от влизането и промяната на състоянието до офертата, одобрението, прехвърлянето и поведението при възстановяване.

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

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