# Centrum programistów: API, OpenAPI i MCP | MerchandAise

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

Twórz integracje produktów personalizowanych z API MerchandAise. Poznaj OpenAPI, osadzanie społeczności, procesy dostawców, firmowe SSO i narzędzia MCP.

## Centrum programistów MerchandAise
Połącz swoją witrynę, systemy firmowe lub asystenta AI z MerchandAise. Poznaj API projektowania produktów, sklepów społeczności, procesów dostawców i tożsamości firmowej oraz dokumentację OpenAPI i MCP pomocną przy integracji.

## Dla systemów wspierających Twój program produktowy
- **Operatorzy społeczności:** Uruchamiaj osadzone sklepy, przejścia do konfiguratora i procesy społeczności na witrynach klubów, lig oraz firm, korzystając z wersjonowanych publicznych specyfikacji.
- **Zespoły firmowe i partnerzy platformy:** Łącz portale zakupowe, systemy tożsamości i operacje wewnętrzne z procesami produktowymi bez ponownego budowania logiki zatwierdzeń i dostawców.
- **Twórcy agentów AI i automatyzacji:** Zapewniaj asystentom uporządkowany dostęp do narzędzi odkrywania produktów, wycen i zatwierdzonych operacji przez interfejsy zgodne z MCP.

## Znajdź swoją integrację
- **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: Poznaj dokumentację API (/pl/developers/api-integrations). Machine-readable contract: OpenAPI narzędzi asystenta w JSON (/api/docs/openapi.json). Access: public. 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 section: /pl/developers#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. 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). Access: public. Publiczna wersjonowana specyfikacja osadzania sklepów, odkrywania społeczności i przekazywania użytkownika z zachowaniem języka witryny. Canonical section: /pl/developers#community-integrations.
- **API dostawców:** Połącz zatwierdzone systemy dostawców z udostępnionymi pakietami produkcyjnymi, statusem kwalifikacji i webhookami ERP lub PLM. 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). Access: public. Publiczna specyfikacja do planowania i generowania klientów API. Operacyjny dostęp dostawców wymaga uprawnień. Canonical section: /pl/developers#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. 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). Access: protected. Chroniona specyfikacja dla zatwierdzonych przestrzeni firmowych; poproś o dostęp przed użyciem tego endpointu. Canonical section: /pl/developers#enterprise-integrations.
- **Agenci AI i MCP:** Połącz asystenta AI przez Model Context Protocol. Odkrywaj obsługiwane narzędzia i zachowuj wybory projektowe użytkownika, jego uprawnienia oraz wymagane potwierdzenia. Human guide: Poznaj agentów AI i MCP (/pl/developers/ai-agents-mcp). Machine-readable contract: Publiczna karta serwera MCP w JSON (/.well-known/mcp/server-card). Access: public. Publiczny dokument odkrywania dla klientów maszynowych. Lista zewnętrznych narzędzi w /api/v1/mcp/tools ujawnia aktualne metadane narzędzi; każde wywołanie nadal podlega zadeklarowanym granicom bezpieczeństwa, przestrzeni i potwierdzeń. Canonical section: /pl/developers#mcp-tools.

## Od pierwszego żądania do produkcji
- **Step 1: Wybierz specyfikację dla swojego procesu:** Zacznij od interfejsu zgodnego z użytkownikiem i modelem autoryzacji: osadzania społeczności, tożsamości firmowej, procesów dostawców lub narzędzi MCP dla asystentów.
- **Step 2: Sprawdź autoryzację, wersjonowanie i granice środowisk:** Potwierdź wymagane nagłówki, zakresy uprawnień, callbacki i wersje specyfikacji w środowisku testowym przed skierowaniem ruchu produkcyjnego.
- **Step 3: Przetestuj pełne procesy przed uruchomieniem:** Zweryfikuj żądania, webhooki, udostępnianie kont, obserwowalność i ścieżki wycofania, aby integracja była niezawodna od pierwszego użycia produkcyjnego.

## Co oznacza gotowość produkcyjna
Integracja produkcyjna wymaga więcej niż publicznego endpointu. Te warunki pomogą ocenić gotowość na ruch klientów, dostawców, użytkowników firmowych lub agentów AI.
- **Środowisko testowe i weryfikacja dostępu:** Potwierdź, które specyfikacje są publiczne, które interfejsy firmowe wymagają zatwierdzenia i jakie poświadczenia lub role w przestrzeni są potrzebne przed uruchomieniem.
- **Dowody wersjonowanego wdrożenia:** Udokumentuj wygenerowane klienty API, adresy callbacków, zakresy autoryzacji, wersje specyfikacji i odpowiedzialność za wycofanie przed włączeniem ruchu produkcyjnego.
- **Obserwowalność operacyjna:** Zaplanuj logi, ponawianie, odpowiedzialność za pomoc, stany błędów i kontrole zdrowia dla każdego procesu wpływającego na zamówienie, dostawcę lub użytkownika firmowego.

## Zanim zaczniesz tworzyć integrację
- **Którego API MerchandAise użyć?:** Użyj API społeczności dla witryn klubów i społeczności, API dostawców dla zatwierdzonych operacji dostawcy oraz API tożsamości firmowej dla logowania i udostępniania kont. Dokumentacja API obejmuje narzędzia asystentów; przewodnik MCP wyjaśnia, jak asystenci AI odkrywają i używają obsługiwanych narzędzi.
- **Czy mogę czytać specyfikacje API bez konta?:** Specyfikacje OpenAPI narzędzi asystentów, społeczności i dostawców są publiczne. Specyfikacja tożsamości firmowej jest chroniona. Czytanie publicznej specyfikacji nie daje uprawnień do wykonywania chronionych żądań ani składania zamówień.
- **Czy integracja programistyczna jest potrzebna do zamówienia produktu?:** Nie. Osoby prywatne, kluby i firmy mogą poznawać obsługiwane produkty i prosić o wycenę na witrynie MerchandAise. API to opcjonalna droga połączenia własnych systemów lub doświadczenia użytkownika.
- **Co zawrzeć w zapytaniu o integrację?:** Opisz użytkowników, systemy, informacje do odczytu lub aktualizacji i planowany harmonogram. Dodaj znane wymagania logowania, środowiska i callbacków. Zespół omówi z Tobą właściwą specyfikację i model dostępu.

## Planujesz własną integrację?
Opisz systemy, proces i harmonogram wdrożenia. Pomożemy wybrać właściwą specyfikację, model dostępu i kolejność uruchomienia.
- **Omów integrację:** /pl/contact/integrations
- **Poznaj rozwiązania dla firm:** /pl/enterprise
