{"pageKey":"Developers","slug":"developers-api-integrations","locale":"bg","localeResolved":"bg","fallbackApplied":false,"version":"developers-api-integrations@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/bg/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"Договори за API и интеграция на мърчандайз | MerchandAise","description":"Разгледайте договорите на MerchandAise за инструменти за асистенти, вграждане в общности, операции на доставчици и корпоративна идентичност, с ясни граници за публичен и защитен достъп.","sections":[{"heading":"Поддържайте единен източник на истина","paragraphs":["Интеграцията трябва да разширява работния процес на MerchandAise, а не да го разклонява. Уебсайтовете, вградените модули, интерфейсите за доставчици, корпоративните системи и бъдещите асистенти трябва да четат и актуализират една и съща версионирана информация за дизайн, търговско намерение, оферта, одобрение и състояние на поръчката.","Когато MerchandAise обработва трансакцията на купувача, Hutter Products GmbH е продавачът по договор и регистрираният търговец (Merchant of Record) под марката MerchandAise. Идентичността и данните за контакт на доставчиците остават поверителни, освен в случаите, когато се изисква разкриване, а производството все още изисква одобрение на дигитална мостра и реална производствена мостра."]},{"heading":"Интерфейси за API и интеграция","items":[{"title":"Документация за API за инструменти за асистенти","description":"Разгледайте текущите крайни точки за асистенти и инструменти за сесии за дизайн и преглед на интеграцията. Тази публична справка не предоставя анонимни права за изготвяне на оферти или генериране на поръчки. 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."},{"title":"API за вграждане в общности","description":"Свържете локализирани преживявания за клубове, общности или витрини на магазини към процесите за прехвърляне на дизайн и търговия, управлявани от 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."},{"title":"API за доставчици","description":"Свържете одобрени доставчици с операции по въвеждане, каталог, оферти и изпълнение на поръчки, след като връзката с доставчика и моделът на достъп бъдат квалифицирани. 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."},{"title":"API за корпоративна идентичност","description":"Планирайте 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."}]},{"heading":"Изберете договора преди кода","items":[{"title":"Step 1: Картографирайте потребителския път","description":"Решете кой влиза в работния процес и откъде: купувач във вградена витрина, одобрен доставчик, корпоративен потребител или асистент, работещ с изрична оторизация."},{"title":"Step 2: Потвърдете границата на достъп","description":"Използвайте публични договори за оценка и генериране на клиенти, след което потвърдете идентификационните данни, обхватите (scopes), средите, обратните повиквания (callbacks) и защитените крайни точки преди внедряването."},{"title":"Step 3: Докажете непрекъснатостта на състоянието","description":"Тествайте дали дизайните, офертите, одобренията, грешките и прехвърлянията на поръчки запазват актуалността на версиите си в рамките на интеграцията, включително при опити за повторение и пътища за връщане назад (rollback)."}]},{"heading":"Какво трябва да запази всяка интеграция","items":[{"title":"Единно версионирано състояние","description":"Дизайнът, търговското намерение, офертата от доставчик, одобрението и статусът на поръчката остават свързани. Неактуалните промени трябва да задействат видимо повторно офериране или състояние на преглед."},{"title":"Търговска поверителност и поверителност на доставчиците","description":"MerchandAise остава търговецът, работещ с купувачите, и собственикът на поддръжката. Идентичността, контактите и вътрешните данни на доставчиците не се разкриват чрез публични интеграции."},{"title":"Одобрение преди производство","description":"Интегрираният 3D изглед на продукта и дигиталната мостра подпомагат вземането на решение, но те не заменят реалната производствена мостра, която се изисква преди масовото производство."}]},{"heading":"Преди пускане в реална среда","paragraphs":["Публикуваният OpenAPI файл е инструмент за планиране, а не обещание за анонимен достъп до реалната среда. Преди пускане в експлоатация преглеждаме средите, идентификационните данни, обработката на грешки и оперативната отговорност."],"items":[{"title":"Достъп и среди","description":"Потвърдете версията на договора, одобреното работно пространство, обхватите на автентификация, тестовата среда (sandbox), производствените идентификационни данни и дестинациите за обратни повиквания."},{"title":"Сривове и възстановяване","description":"Дефинирайте опитите за повторение, идемпотентността, изтичането на времето (timeouts), видимите за клиентите грешки, възможностите за наблюдение (observability), отговорността за поддръжката и връщането назад преди пускането."},{"title":"Доказателство от край до край","description":"Проверете планирания потребителски път в тестовата среда (staging) – от влизането и промяната на състоянието до офертата, одобрението, прехвърлянето и поведението при възстановяване."}]},{"heading":"Често задавани въпроси","items":[{"title":"С кой интерфейс за интеграция трябва да започна?","description":"Започнете с потребителя и прехода на състоянието. Използвайте вграждания в общности за потребителски пътища на клубове или общности, насочени към купувачите; операции за доставчици за одобрени работни процеси от страна на доставката; корпоративна идентичност за SSO и SCIM; и инструменти за асистенти само за изрично оторизирани процеси, управлявани от AI."},{"title":"Означава ли публичният договор публичен достъп до реална среда?","description":"Не. Публичният OpenAPI договор подпомага проучването, прегледа на архитектурата и генерирането на клиенти. Производствените идентификационни данни, операциите за запис, работните процеси на доставчиците, корпоративната идентичност и изпълнението от асистенти все още могат да изискват одобрено работно пространство и ограничена по обхват оторизация."},{"title":"Може ли интеграцията да разкрие доставчици или да заобиколи одобренията?","description":"Не. Идентичността и данните за контакт на доставчиците остават поверителни, освен ако не се изисква разкриване, MerchandAise управлява връзката с купувача, а действията, засягащи поръчките, трябва да запазят конфигурираните етапи за одобрение и реална производствена мостра."}]},{"heading":"Представете ни работния процес, а не завършена архитектура.","paragraphs":["Кажете ни кой ще използва интеграцията, кое състояние трябва да чете или променя и къде ще се намира потребителското преживяване. Ние ще картографираме договора, модела на достъп и най-безопасния път за внедряване заедно с вас."],"items":[{"title":"Планиране на интеграция","description":"/bg/contact?intent=api-integration-review"},{"title":"Разгледайте AI агенти и MCP","description":"/bg/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}