{"pageKey":"Developers","slug":"developers-api-integrations","locale":"pl","localeResolved":"pl","fallbackApplied":false,"version":"developers-api-integrations@2026-11-19T13:10:47.762Z","lastModified":null,"canonicalUrl":"https://www.merchandaise.com/pl/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"Dokumentacja API i integracje OpenAPI | MerchandAise","description":"Poznaj dokumentację API i specyfikacje OpenAPI MerchandAise dla produktów personalizowanych, osadzania społeczności, procesów dostawców i tożsamości firmowej.","sections":[{"heading":"Wybierz połączenie potrzebne w Twoim projekcie","paragraphs":["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."]},{"heading":"Interfejsy API i integracji","items":[{"title":"Dokumentacja API i OpenAPI","description":"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."},{"title":"API społeczności","description":"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."},{"title":"API dostawców","description":"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."},{"title":"API tożsamości firmowej","description":"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."}]},{"heading":"Wybierz specyfikację przed pisaniem kodu","items":[{"title":"Step 1: Zmapuj drogę użytkownika","description":"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."},{"title":"Step 2: Potwierdź granice dostępu","description":"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."},{"title":"Step 3: Potwierdź ciągłość stanu","description":"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."}]},{"heading":"Co każda integracja musi zachować","items":[{"title":"Jeden wersjonowany stan","description":"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."},{"title":"Prywatność danych handlowych i dostawców","description":"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."},{"title":"Zatwierdzenie przed produkcją","description":"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."}]},{"heading":"Przed uruchomieniem ruchu produkcyjnego","paragraphs":["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ą."],"items":[{"title":"Dostęp i środowiska","description":"Potwierdź wersję specyfikacji, zatwierdzoną przestrzeń, zakresy autoryzacji, środowisko testowe, poświadczenia produkcyjne i adresy callbacków."},{"title":"Błędy i powrót do działania","description":"Określ ponawianie, idempotencję, limity czasu, błędy widoczne dla klienta, obserwowalność, odpowiedzialność za pomoc i wycofanie przed publikacją."},{"title":"Dowody pełnego procesu","description":"Zweryfikuj zaplanowaną drogę w środowisku testowym: od wejścia i zmiany stanu przez wycenę, zatwierdzenie i przekazanie aż po odzyskanie działania."}]},{"heading":"Pytania i odpowiedzi","items":[{"title":"Od którego API produktów personalizowanych zacząć?","description":"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."},{"title":"Czy publiczna specyfikacja oznacza publiczny dostęp produkcyjny?","description":"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ń."},{"title":"Czy integracja może ujawniać dostawców lub omijać zatwierdzenia?","description":"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."}]},{"heading":"Zaplanuj integrację z nami.","paragraphs":["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."],"items":[{"title":"Zaplanuj integrację","description":"/pl/contact?intent=api-integration-review"},{"title":"Poznaj agentów AI i MCP","description":"/pl/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"route-owned-source","schema":"2025-11-05"}}