{"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.","Where MerchandAise processes the buyer transaction, Hutter Products GmbH is the contracting seller and Merchant of Record under the MerchandAise brand. Supplier identity and contact details stay private except where disclosure is required, and production still requires digital-proof approval, confirmed producibility, mandatory technical checks, and the sample approvals applicable to the exact accepted order."]},{"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). Dostęp: Publiczny. 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). Dostęp: Publiczny. 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). Dostęp: Publiczny. 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). Dostęp: Chroniony. 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":"A 3D view is not physical evidence. The confirmed quote explains any available customer-sample choices, costs, limitations, and timing. Approve the exact digital proof and complete mandatory technical checks and any required or selected sample approval before mass production. Existing accepted-order requirements remain binding."}]},{"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":"No. Supplier identity and contact details remain private except where disclosure is required, MerchandAise owns the buyer relationship, and order-affecting actions must preserve the configured digital-proof, technical, and order-specific sample approval requirements."}]},{"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"}}