# Kontrakty API i integracji produktów | MerchandAise

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

Poznaj kontrakty MerchandAise dla narzędzi asystenckich, osadzania społeczności, operacji dostawców i tożsamości przedsiębiorstwa, z jasnymi granicami dostępu publicznego i chronionego.

## Zachowaj jedno źródło prawdy
Integracja powinna rozszerzać proces MerchandAise, a nie tworzyć jego rozgałęzienia. Strony internetowe, elementy osadzone, systemy dostawców, przedsiębiorstw oraz przyszłe interfejsy asystentów muszą odczytywać i aktualizować ten sam wersjonowany stan projektu, intencji handlowej, wyceny, zatwierdzenia i zamówienia.
W przypadkach, gdy MerchandAise przetwarza transakcję kupującego, Hutter Products GmbH jest sprzedawcą kontraktowym i podmiotem odpowiedzialnym za sprzedaż (Merchant of Record) pod marką MerchandAise. Tożsamość i dane kontaktowe dostawców pozostają poufne, z wyjątkiem sytuacji, gdy wymagane jest ich ujawnienie, a produkcja nadal wymaga zatwierdzenia cyfrowej próby oraz rzeczywistej próbki produkcyjnej.

## Obszary integracji i API
- **Dokumentacja API narzędzi asystenckich:** Poznaj aktualne punkty końcowe dla asystentów i narzędzi do obsługi sesji projektowych oraz przeglądu integracji. To publiczne źródło referencyjne nie uprawnia do anonimowego wnioskowania o wycenę ani składania zamówień. Human guide: Otwórz dokumentację narzędzi asystenckich (/pl/developers/api-integrations). Machine-readable contract: Plik JSON OpenAPI narzędzi asystenckich (/api/docs/openapi.json). Access: public. Publiczne źródło referencyjne dla API asystentów i narzędzi. Dostęp produkcyjny oraz operacje wpływające na zamówienia nadal wymagają odpowiedniej autoryzacji. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs.
- **API do osadzania społeczności:** Połącz lokalne kluby, społeczności lub witryny sklepowe z procesami projektowania i transakcji obsługiwanymi przez MerchandAise, bez konieczności przebudowywania bazowego przepływu pracy. Human guide: Przejrzyj przewodnik integracji społeczności (/pl/developers/api-integrations#community-integrations). Machine-readable contract: Plik JSON OpenAPI dla społeczności (/api/v1/community/public/openapi/v1). Access: public. Publiczny, wersjonowany kontrakt dla osadzonych witryn sklepowych, wyszukiwania społeczności i przekazywania danych z uwzględnieniem lokalizacji. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations.
- **API dostawcy:** Połącz zatwierdzonych dostawców z procesami wdrożenia, katalogu, wyceny i realizacji zamówień po zweryfikowaniu relacji z dostawcą i modelu dostępu. Human guide: Przejrzyj przewodnik integracji dostawcy (/pl/developers/api-integrations#supplier-integrations). Machine-readable contract: Plik JSON OpenAPI dostawcy (/api/v1/supplier/openapi/v1). Access: public. Publiczny kontrakt do planowania i generowania klientów. Operacyjny dostęp dostawcy wymaga posiadania odpowiednich uprawnień. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations.
- **API tożsamości przedsiębiorstwa:** Zaplanuj SSO, aprowizację SCIM oraz zgodne z wymogami audytu przepływy tożsamości dla zatwierdzonych programów artykułów reklamowych i kontrolowanych wdrożeń. Human guide: Przejrzyj przewodnik integracji dla przedsiębiorstw (/pl/developers/api-integrations#enterprise-integrations). Machine-readable contract: Plik JSON OpenAPI tożsamości przedsiębiorstwa (/api/v1/enterprise/identity/openapi/v1). Access: protected. Chroniony kontrakt dla zatwierdzonych przestrzeni roboczych przedsiębiorstw; poproś o dostęp przed użyciem tego punktu końcowego. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations.

## Wybierz kontrakt przed napisaniem kodu
- **Step 1: Odwzoruj ścieżkę użytkownika:** Zdecyduj, kto i w którym miejscu dołącza do procesu: kupujący w osadzonej witrynie sklepowej, zatwierdzony dostawca, użytkownik korporacyjny czy asystent działający na podstawie wyraźnego upoważnienia.
- **Step 2: Potwierdź granice dostępu:** Użyj publicznych kontraktów do oceny i generowania klientów, a następnie przed wdrożeniem potwierdź dane uwierzytelniające, zakresy, środowiska, adresy zwrotne (callbacks) i chronione punkty końcowe.
- **Step 3: Zweryfikuj ciągłość stanu:** Przetestuj, czy projekty, wyceny, zatwierdzenia, błędy i przekazywanie zamówień zachowują aktualność wersji w ramach integracji, w tym w przypadku ponownych prób i ścieżek wycofywania zmian (rollback).

## Co musi zachować każda integracja
- **Jeden wersjonowany stan:** Projekt, intencja handlowa, wycena oparta na ofercie dostawcy, zatwierdzenie i status zamówienia pozostają połączone. Nieaktualne zmiany muszą wywołać widoczny stan ponownej wyceny lub weryfikacji.
- **Poufność handlowa i dane dostawców:** MerchandAise pozostaje sprzedawcą obsługującym kupującego i właścicielem wsparcia. Tożsamość dostawców, kontakty i dane wewnętrzne nie są ujawniane za pośrednictwem publicznych integracji.
- **Zatwierdzenie przed produkcją:** Natywny widok 3D produktu i cyfrowa próba wspierają podjęcie decyzji, ale nie zastępują rzeczywistej próbki produkcyjnej wymaganej przed rozpoczęciem produkcji masowej.

## Przed uruchomieniem ruchu produkcyjnego
Opublikowany plik OpenAPI służy do planowania, a nie stanowi obietnicy anonimowego dostępu produkcyjnego. Przed uruchomieniem produkcyjnym weryfikujemy środowiska, dane uwierzytelniające, obsługę błędów i odpowiedzialność operacyjną.
- **Dostęp i środowiska:** Potwierdź wersję kontraktu, zatwierdzoną przestrzeń roboczą, zakresy uwierzytelniania, środowisko testowe (sandbox), dane uwierzytelniające do środowiska produkcyjnego oraz docelowe adresy zwrotne (callbacks).
- **Obsługa błędów i przywracanie działania:** Przed wydaniem zdefiniuj ponowne próby, idempotentność, limity czasu (timeouts), błędy widoczne dla klientów, monitorowanie (observability), odpowiedzialność za wsparcie oraz wycofywanie zmian (rollback).
- **Weryfikacja end-to-end:** Zweryfikuj zaplanowaną ścieżkę w środowisku testowym (staging) – od wejścia i zmiany stanu, przez wycenę, zatwierdzenie, przekazanie, aż po zachowanie w przypadku przywracania działania.

## FAQ
- **Od którego obszaru integracji powinienem zacząć?:** Zacznij od użytkownika i przejścia stanu. Użyj osadzania społeczności dla ścieżek klubowych lub społecznościowych skierowanych do kupujących, operacji dostawców dla zatwierdzonych procesów po stronie dostaw, tożsamości przedsiębiorstwa dla SSO i SCIM, a narzędzi asystenckich wyłącznie dla wyraźnie autoryzowanych procesów kierowanych przez AI.
- **Czy publiczny kontrakt oznacza publiczny dostęp produkcyjny?:** Nie. Publiczny kontrakt OpenAPI służy do analizy, przeglądu architektury i generowania klientów. Dane uwierzytelniające do środowiska produkcyjnego, operacje zapisu, procesy dostawców, tożsamość przedsiębiorstwa oraz uruchamianie asystentów mogą nadal wymagać zatwierdzonej przestrzeni roboczej i autoryzacji o określonym zakresie.
- **Czy integracja może ujawnić dostawców lub pominąć zatwierdzenia?:** Nie. Tożsamość i dane kontaktowe dostawców pozostają poufne, z wyjątkiem sytuacji, gdy wymagane jest ich ujawnienie. MerchandAise odpowiada za relacje z kupującym, a działania wpływające na zamówienie muszą zachować skonfigurowane etapy zatwierdzania oraz wymóg rzeczywistej próbki.

## Przedstaw nam proces, a nie gotową architekturę.
Powiedz nam, kto będzie korzystał z integracji, jaki stan musi odczytywać lub zmieniać i gdzie będzie osadzona ta usługa. Wspólnie dopasujemy kontrakt, model dostępu i najbezpieczniejszą ścieżkę wdrożenia.
- **Zaplanuj integrację:** /pl/contact?intent=api-integration-review
- **Poznaj agentów AI i MCP:** /pl/developers/ai-agents-mcp