# Dokumentacja API i integracje OpenAPI | MerchandAise

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

Poznaj dokumentację API i specyfikacje OpenAPI MerchandAise dla produktów personalizowanych, osadzania społeczności, procesów dostawców i tożsamości firmowej.

## Wybierz połączenie potrzebne w Twoim projekcie
Poniższa dokumentacja pozwala ocenić endpointy, formaty żądań i wymagania autoryzacyjne. Publiczne specyfikacje służą planowaniu i generowaniu klientów API; dostęp operacyjny zależy od API, konta i środowiska.
Gdy MerchandAise obsługuje transakcję kupującego, Hutter Products GmbH jest sprzedawcą będącym stroną umowy i Merchant of Record pod marką MerchandAise. Tożsamość i dane kontaktowe dostawcy pozostają prywatne, poza wymaganymi ujawnieniami. Produkcja nadal wymaga zatwierdzenia projektu cyfrowego, potwierdzenia wykonalności, obowiązkowych kontroli technicznych i zatwierdzeń próbek właściwych dla konkretnego przyjętego zamówienia.

## Interfejsy API i integracji
- **Dokumentacja API i OpenAPI:** Znajdź dokumentację API narzędzi asystentów i sesji projektowych, a następnie wybierz specyfikację dla społeczności, dostawców lub firm odpowiadającą Twojemu procesowi. Human guide: Czytaj dokumentację narzędzi asystenta (/api/docs). Machine-readable contract: OpenAPI narzędzi asystenta w JSON (/api/docs/openapi.json). Dostęp: Publiczny. Publiczna dokumentacja API asystentów i narzędzi. Dostęp produkcyjny i operacje wpływające na zamówienia nadal wymagają właściwych uprawnień. Canonical page: /pl/developers/api-integrations. Canonical section: /pl/developers/api-integrations#api-docs.
- **API społeczności:** Połącz witrynę klubu lub społeczności z informacjami publicznymi, przesyłaniem projektów, głosowaniem i przekazywaniem zamówień do zatwierdzenia. Co obejmuje specyfikacja: Publiczny kontekst społeczności, posty projektowe i głosy, publikację ofert, oczekujące zamówienia oraz zatwierdzanie lub odrzucanie przez właściciela społeczności. Praktyczny punkt wyjścia: Odczytaj publiczny kontekst społeczności dla witryny klubu. Następnie określ, które czynności wymagają sesji członka lub uprawnień właściciela, zanim dodasz przesyłanie projektów lub przejście do zamówienia. Dostęp: Specyfikacja jest publiczna. Odczyty publiczne, działania członków i operacje zastrzeżone dla właściciela mają różne wymagania autoryzacyjne; przestrzegaj zasad bezpieczeństwa każdego endpointu. Human guide: Poznaj API społeczności (/pl/developers/api-integrations#community-integrations). Machine-readable contract: OpenAPI społeczności w JSON (/api/v1/community/public/openapi/v1). Dostęp: Publiczny. Publiczna wersjonowana specyfikacja osadzania sklepów, odkrywania społeczności i przekazywania użytkownika z zachowaniem języka witryny. Canonical page: /pl/developers/api-integrations. Canonical section: /pl/developers/api-integrations#community-integrations.
- **API dostawców:** Połącz zatwierdzone systemy dostawców z udostępnionymi pakietami produkcyjnymi, statusem kwalifikacji i webhookami ERP lub PLM. Co obejmuje specyfikacja: Stan kwalifikacji dostawcy, udostępnione pakiety produkcyjne, audytowane pobieranie plików, analitykę, subskrypcje webhooków i punkty synchronizacji. Praktyczny punkt wyjścia: Zaplanuj połączenie systemu ERP lub zarządzania cyklem życia produktu z Centrum dostawcy. Sprawdź dane webhooków, ponawianie i status synchronizacji przed obsługą przypisanego zamówienia. Dostęp: Czytaj specyfikację OpenAPI bez logowania. Żądania operacyjne wymagają odpowiedniego konta dostawcy i uprawnień; publiczna dokumentacja nie rejestruje dostawcy ani nie daje dostępu do danych innych dostawców. Human guide: Poznaj API dostawców (/pl/developers/api-integrations#supplier-integrations). Machine-readable contract: OpenAPI dostawców w JSON (/api/v1/supplier/openapi/v1). Dostęp: Publiczny. Publiczna specyfikacja do planowania i generowania klientów API. Operacyjny dostęp dostawców wymaga uprawnień. Canonical page: /pl/developers/api-integrations. Canonical section: /pl/developers/api-integrations#supplier-integrations.
- **API tożsamości firmowej:** Połącz zatwierdzone przestrzenie firmowe z jednokrotnym logowaniem, udostępnianiem użytkowników i grup oraz rejestrami audytu tożsamości. Co obejmuje specyfikacja: Jednokrotne logowanie OpenID Connect (OIDC), zarządzanie cyklem życia użytkowników i grup SCIM, rotację tokenów SCIM i zdarzenia audytu udostępniania kont. Praktyczny punkt wyjścia: Powiąż dostawcę tożsamości z zatwierdzoną przestrzenią. Zaplanuj logowanie, tworzenie i dezaktywację kont, a następnie sprawdź mapowanie grup oraz rejestry audytu w uzgodnionym środowisku testowym. Dostęp: Specyfikacja tożsamości firmowej jest chroniona. Skontaktuj się z zespołem integracji, aby omówić przestrzeń i wymagania dostępu przed wdrożeniem. Tożsamość firmowa jest opcjonalna przy zwykłych zakupach produktów. Human guide: Poznaj tożsamość firmową (/pl/developers/api-integrations#enterprise-integrations). Machine-readable contract: OpenAPI tożsamości firmowej w JSON (/api/v1/enterprise/identity/openapi/v1). Dostęp: Chroniony. Chroniona specyfikacja dla zatwierdzonych przestrzeni firmowych; poproś o dostęp przed użyciem tego endpointu. Canonical page: /pl/developers/api-integrations. Canonical section: /pl/developers/api-integrations#enterprise-integrations.

## Wybierz specyfikację przed pisaniem kodu
- **Step 1: Zmapuj drogę użytkownika:** Określ, kto i gdzie wchodzi do procesu: kupujący w osadzonym sklepie, zatwierdzony dostawca, użytkownik firmowy czy asystent działający z wyraźnymi uprawnieniami.
- **Step 2: Potwierdź granice dostępu:** Użyj publicznych specyfikacji do oceny i generowania klientów API, a następnie potwierdź poświadczenia, zakresy uprawnień, środowiska, callbacki i chronione endpointy przed wdrożeniem.
- **Step 3: Potwierdź ciągłość stanu:** Sprawdź, czy projekty, wyceny, zatwierdzenia, błędy i przekazanie zamówienia zachowują aktualną wersję w całej integracji, także przy ponowieniach i wycofaniu zmian.

## Co każda integracja musi zachować
- **Jeden wersjonowany stan:** Projekt, zamiar zakupu, wycena potwierdzona przez dostawcę, zatwierdzenie i status zamówienia pozostają połączone. Nieaktualne zmiany muszą wywołać widoczny stan ponownej wyceny lub weryfikacji.
- **Prywatność danych handlowych i dostawców:** MerchandAise pozostaje sprzedawcą i zespołem pomocy dla kupującego. Tożsamości, kontakty i dane wewnętrzne dostawców nie są ujawniane przez publiczne integracje.
- **Zatwierdzenie przed produkcją:** Widok 3D nie jest dowodem fizycznym. Potwierdzona wycena opisuje dostępne opcje próbek dla klienta, koszty, ograniczenia i terminy. Przed produkcją seryjną zatwierdź dokładny projekt cyfrowy, zakończ obowiązkowe kontrole techniczne i zatwierdź wymagane lub wybrane próbki. Wymagania już przyjętych zamówień pozostają wiążące.

## Przed uruchomieniem ruchu produkcyjnego
Opublikowany plik OpenAPI służy planowaniu, nie obiecuje anonimowego dostępu produkcyjnego. Przed uruchomieniem sprawdzamy środowiska, poświadczenia, obsługę błędów i odpowiedzialność operacyjną.
- **Dostęp i środowiska:** Potwierdź wersję specyfikacji, zatwierdzoną przestrzeń, zakresy autoryzacji, środowisko testowe, poświadczenia produkcyjne i adresy callbacków.
- **Błędy i powrót do działania:** Określ ponawianie, idempotencję, limity czasu, błędy widoczne dla klienta, obserwowalność, odpowiedzialność za pomoc i wycofanie przed publikacją.
- **Dowody pełnego procesu:** Zweryfikuj zaplanowaną drogę w środowisku testowym: od wejścia i zmiany stanu przez wycenę, zatwierdzenie i przekazanie aż po odzyskanie działania.

## Pytania i odpowiedzi
- **Od którego API produktów personalizowanych zacząć?:** Zacznij od użytkownika i zmiany stanu. Użyj osadzania społeczności dla ścieżek klubów i społeczności, operacji dostawców dla zatwierdzonych procesów produkcyjnych, tożsamości firmowej dla SSO i SCIM oraz narzędzi asystentów wyłącznie dla wyraźnie autoryzowanych procesów AI.
- **Czy publiczna specyfikacja oznacza publiczny dostęp produkcyjny?:** Nie. Publiczna specyfikacja OpenAPI wspiera odkrywanie API, ocenę architektury i generowanie klientów. Poświadczenia produkcyjne, zapisy, procesy dostawców, tożsamość firmowa i działania asystentów mogą nadal wymagać zatwierdzonej przestrzeni i ograniczonych uprawnień.
- **Czy integracja może ujawniać dostawców lub omijać zatwierdzenia?:** Nie. Tożsamość i kontakty dostawców pozostają prywatne, poza wymaganymi ujawnieniami. MerchandAise prowadzi relację z kupującym, a działania wpływające na zamówienie muszą zachować skonfigurowane wymagania zatwierdzania projektu cyfrowego, kontroli technicznych i próbek dla danego zamówienia.

## Zaplanuj integrację z nami.
Powiedz, kto będzie korzystał z integracji, jaki stan ma odczytywać lub zmieniać i gdzie będzie działać. Wspólnie ustalimy specyfikację, model dostępu i najbezpieczniejszą drogę wdrożenia.
- **Zaplanuj integrację:** /pl/contact?intent=api-integration-review
- **Poznaj agentów AI i MCP:** /pl/developers/ai-agents-mcp
