Jeden API dla całego katalogu obejmującego wiele sklepów

Przeszukuj pełny kontekst produktu, aktualizuj dane główne lub specyficzne dla sklepu z walidacją i publikuj w odpowiednich witrynach sklepowych Shopify za pomocą jednego spójnego API.

Porozmawiaj z nami Zobacz dokumentację API

PeakDeweloper APIwersja 42200 Opublikowano

Model produktuKurtka alpejskaDane podstawowe wersja 42Sklep amerykański Aktywnysklep FR Wersja roboczasklep DE Aktywny

ŁATKA/v1/products/prod_82/stores/fr

{
  „wersja”: 42,
  „tytuł”: "Veste Alpine",
  "seo_opis": „Une veste…”
}

Zatwierdzony projektwersja 43

POST/v1/products/prod_82/publish

{ „sklepy”: [„fr”], „status”: „opublikowano” }

Zaufało nam ponad 50 najlepszych sprzedawców na całym świecie

Katalog API, a nie surowe tabele

Opieraj się na modelu produktu, którym zarządza już Peak PIM

Zapewnij integracjom niezawodny sposób na zrozumienie udostępnionych danych, różnic w witrynach sklepowych, bezpiecznych zapisów i stanu publikowania.

Dane z witryny sklepu fragmentują model produktu

Niestandardowe integracje często rekonstruują dane główne i wersje specyficzne dla sklepu z oddzielnych wywołań, zanim będą mogły wykonać użyteczną pracę.

Zapisywanie w katalogu wymaga czegoś więcej niż punktu końcowego

Walidacja, konflikty wersji, wersje robocze, warianty, media i relacje w kolekcji mają znaczenie, gdy częściowa aktualizacja trafia do środowiska produkcyjnego.

Publikowanie to odrębny proces

Przenoszenie zweryfikowanej zmiany do jednego, kilku lub wszystkich sklepów Shopify powinno odbywać się przy użyciu przewidywalnego potoku, a nie kolejnej kolekcji niestandardowych skryptów.

Zobacz jak to działa

Czytaj, pisz, publikuj

Przewidywalna ścieżka od żądania do witryny sklepowej

Korzystaj z uporządkowanych odczytów katalogów, kontrolowanych częściowych aktualizacji i tego samego przepływu pracy związanego z publikowaniem w wielu sklepach, co aplikacja Peak PIM.

POBIERZ /produkty

DOBIERZ /v1/produkty
?wyszukiwanie=alpejskie
&store=fr
&stan=wersja robocza

200 · 24 wyniki
strona 1 z 3

Zapytanie

Przeczytaj cały kontekst produktu

Wyszukuj i filtruj produkty, warianty, kolekcje, multimedia i definicje metapól, a następnie pobieraj dane podstawowe i przechowuj razem wersje.

PATCH /produkty/:id

ŁATKA /sklepy/fr
Jeśli-Match: wersja-42

tytuł: "Veste Alpine"

200 · wersja-43
stan: wersja robocza

Aktualizacja

Popraw dokładnie tę warstwę, którą zamierzasz

Aktualizuj dane główne lub wersję jednego sklepu za pomocą sprawdzania poprawności pól, zachowania w pierwszej wersji roboczej, tokenów nośnika o określonym zakresie i kontroli wersji, które odrzucają nieaktualne zapisy.

WYŚLIJ / opublikuj

1SprawdźMistrz + wersje2PublikujUSA · FR · DE3SynchronizujWarianty + mediaUkończono poprzez potok Peak

Publikuj

Użyj jednego potoku obejmującego wiele sklepów

Publikuj w jednym, kilku lub wszystkich połączonych sklepach, podczas gdy Peak PIM koordynuje warianty, multimedia i członkostwo w kolekcjach w ramach tego samego przepływu pracy, co aplikacja.

Zbudowany z myślą o integracji

Kontroluje potrzeby pracy w katalogu produkcyjnym

API wyraźnie określa uprawnienia, wersje, wersje robocze i publikowanie, dzięki czemu integracja może bezpiecznie zakończyć się niepowodzeniem.

Dowiedz się więcej

Ujednolicony model produktu

Przeczytaj główne informacje o produktach i wersje poszczególnych sklepów w jednej ustrukturyzowanej odpowiedzi, zamiast odbudowywać relacje po stronie klienta.

Głębokie odczyty i precyzyjne zapytania

Użyj wyszukiwania pełnotekstowego, filtrów, sortowania, paginacji i powiązanych rekordów, aby uzyskać kontekst, którego faktycznie potrzebuje integracja.

Bezpieczne częściowe aktualizacje

Zakresy oddzielają dostęp do odczytu, zapisu i publikowania. Optymistyczna współbieżność powoduje konflikt zamiast cichego akceptowania nieaktualnej wersji.

Jawne publikowanie Shopify

Zapisy pozostają wersjami roboczymi, dopóki żądanie opublikowania nie będzie skierowane do zamierzonych sklepów, dzięki czemu mutacja katalogu będzie oddzielona od wydania w sklepie.

Często zadawane pytania

Wszystko, co programiści muszą wiedzieć przed rozpoczęciem tworzenia Peak PIM API.

Co mogę zbudować za pomocą Peak PIM API?

Możesz budować integracje katalogów, połączenia z dostawcami i ERP, wewnętrzne narzędzia produktów, automatyzację, raportowanie i inne przepływy pracy, które wymagają zorganizowanego dostępu do wielosklepowego katalogu Peak PIM.

Jakie zasoby katalogu są dostępne?

API obejmuje produkty, warianty, kolekcje, media, definicje metapól, dane główne i wersje specyficzne dla sklepu, z wyszukiwaniem, filtrowaniem, sortowaniem, paginacją i odczytem powiązanych rekordów.

Czy mogę zaktualizować jeden sklep Shopify bez zmiany pozostałych?

Tak. Popraw wersję specyficzną dla sklepu, jeśli zmiana dotyczy jednej witryny sklepowej, lub popraw dane główne, jeśli powinna obowiązywać w udostępnionej warstwie produktu.

Jak działa publikacja?

Publikowanie to wyraźna akcja po zapisie. Wybierz jeden, kilka lub wszystkie połączone sklepy, a Peak PIM przeprowadzi zmianę poprzez swój potok publikowania Shopify z powiązanymi wariantami, multimediami i członkostwami w kolekcji.

Jaki jest zakres dostępu API?

Poświadczenia nośnika korzystają z oddzielnych zakresów pim:read, pim:write i pim:publish, dzięki czemu integracja otrzymuje tylko potrzebne funkcje. Nie ma zakresu usuwania.

W jaki sposób obsługiwane są równoczesne aktualizacje?

Żądania aktualizacji obejmują rewizję rekordu. Jeśli inna zmiana przyspieszyła tę wersję, Peak PIM odrzuca nieaktualny zapis za pomocą protokołu HTTP 409, aby klient mógł go odświeżyć i celowo rozwiązać.

Czy aktualizacja API natychmiast zmienia Shopify?

Nie. Aktualizacje są najpierw wersją roboczą. Klient wysyła osobne żądanie publikacji, gdy zatwierdzona zmiana będzie gotowa dla wybranych witryn sklepowych.

Gdzie mogę uzyskać dostęp do dokumentacji API?

Publiczna dokumentacja programisty zawiera odniesienie do API, wskazówki dotyczące uwierzytelniania i szczegóły punktu końcowego pod adresem https://developers.peak-pim.com/.

Zobacz dokumentację API

W jaki sposób API jest powiązany ze złączem AI (MCP)?

Złącze AI (MCP) udostępnia te same możliwości katalogu, co narzędzia do konwersacji tekstowej na zdalnym serwerze MCP. Użyj REST API do oprogramowania niestandardowego lub złącza, jeśli interfejsem jest gotowy asystent AI.

Nadal masz pytania?

Skontaktuj się z naszym zespołem, a pomożemy Ci znaleźć odpowiednią konfigurację.

Porozmawiaj z nami