{"pageKey":"Developers","slug":"developers-api-integrations","locale":"pl","localeResolved":"pl","fallbackApplied":false,"version":"developers-api-integrations@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/pl/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"Kontrakty API i integracji produktów | MerchandAise","description":"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.","sections":[{"heading":"Zachowaj jedno źródło prawdy","paragraphs":["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."]},{"heading":"Obszary integracji i API","items":[{"title":"Dokumentacja API narzędzi asystenckich","description":"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."},{"title":"API do osadzania społeczności","description":"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."},{"title":"API dostawcy","description":"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."},{"title":"API tożsamości przedsiębiorstwa","description":"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."}]},{"heading":"Wybierz kontrakt przed napisaniem kodu","items":[{"title":"Step 1: Odwzoruj ścieżkę użytkownika","description":"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."},{"title":"Step 2: Potwierdź granice dostępu","description":"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."},{"title":"Step 3: Zweryfikuj ciągłość stanu","description":"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)."}]},{"heading":"Co musi zachować każda integracja","items":[{"title":"Jeden wersjonowany stan","description":"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."},{"title":"Poufność handlowa i dane dostawców","description":"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."},{"title":"Zatwierdzenie przed produkcją","description":"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."}]},{"heading":"Przed uruchomieniem ruchu produkcyjnego","paragraphs":["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ą."],"items":[{"title":"Dostęp i środowiska","description":"Potwierdź wersję kontraktu, zatwierdzoną przestrzeń roboczą, zakresy uwierzytelniania, środowisko testowe (sandbox), dane uwierzytelniające do środowiska produkcyjnego oraz docelowe adresy zwrotne (callbacks)."},{"title":"Obsługa błędów i przywracanie działania","description":"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)."},{"title":"Weryfikacja end-to-end","description":"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."}]},{"heading":"FAQ","items":[{"title":"Od którego obszaru integracji powinienem zacząć?","description":"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."},{"title":"Czy publiczny kontrakt oznacza publiczny dostęp produkcyjny?","description":"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."},{"title":"Czy integracja może ujawnić dostawców lub pominąć zatwierdzenia?","description":"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."}]},{"heading":"Przedstaw nam proces, a nie gotową architekturę.","paragraphs":["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."],"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":"page-content","schema":"2025-11-05"}}