Platforma programistów MerchandAise
Połącz swój proces z MerchandAise.
Znajdź dokumentację API i specyfikacje OpenAPI dla produktów personalizowanych. Połącz witryny, społeczności, operacje dostawców lub konta firmowe ze wspólnymi informacjami o projektach, wycenach i zamówieniach.
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.
01 — Specyfikacje
Interfejsy API i integracji
01
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.
Przewodnik wdrożenia
Czytaj dokumentację narzędzi asystentaSpecyfikacja dla systemów
OpenAPI narzędzi asystenta w JSON/api/docs/openapi.jsonPubliczna dokumentacja API asystentów i narzędzi. Dostęp produkcyjny i operacje wpływające na zamówienia nadal wymagają właściwych uprawnień.
02
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.
Specyfikacja dla systemów
OpenAPI społeczności w JSON/api/v1/community/public/openapi/v1Publiczna wersjonowana specyfikacja osadzania sklepów, odkrywania społeczności i przekazywania użytkownika z zachowaniem języka witryny.
03
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.
Specyfikacja dla systemów
OpenAPI dostawców w JSON/api/v1/supplier/openapi/v1Publiczna specyfikacja do planowania i generowania klientów API. Operacyjny dostęp dostawców wymaga uprawnień.
04
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.
Specyfikacja dla systemów
OpenAPI tożsamości firmowej w JSON/api/v1/enterprise/identity/openapi/v1Chroniona specyfikacja dla zatwierdzonych przestrzeni firmowych; poproś o dostęp przed użyciem tego endpointu.
Zaplanuj integrację02 — Przewodnik wdrożenia
Wybierz specyfikację przed pisaniem kodu
- 01
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.
- 02
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.
- 03
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.
03 — Co każda integracja musi zachować
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.
04
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.