マルチストアカタログ全体に 1 つの API

完全な商品コンテキストを検索し、検証を使用してマスターまたはストア固有のデータを更新し、1 つの一貫した API を通じて適切な Shopify ストアフロントに公開します。

Peak開発者 APIリビジョン42200 件発行

商品型式アルパインジャケットマスターデータ rev 42米国ストア アクティブFRストア草案DEストア アクティブ

パッチ/v1/商品/prod_82/ストア/fr

{
  「改訂」: 42,
  「タイトル」：「ヴェステ・アルパイン」、
  「seo_description」：「うーん、もう…」
}

検証済みのドラフトリビジョン43

投稿/v1/商品/prod_82/パブリッシュ

{ "ストア": ["fr"]、"ステータス": 「出版された」 }

世界中の70以上のトップマーチャントから信頼されています

ケーススタディ

生のテーブルではなく、カタログ API

Peak PIM がすでに管理している商品モデルをベースに構築

統合により、共有データ、ストアフロントの違い、安全な書き込み、公開状態を理解するための信頼できる方法が提供されます。

店頭データは商品モデルを断片化する

カスタム統合では、有用な作業を実行する前に、個別の呼び出しからマスターデータとストア固有のバージョンを再構築することがよくあります。

カタログの書き込みにはエンドポイント以上のものが必要です

部分的な更新が運用環境に到達すると、検証、リビジョンの競合、ドラフト、バリアント、メディア、およびコレクションの関係がすべて重要になります。

公開は独自のワークフローです

検証された変更を 1 つ、複数、またはすべての Shopify ストアに移動するには、別のカスタムスクリプトのコレクションではなく、予測可能なパイプラインを使用する必要があります。

どのように機能するか見てみましょう

読む、書く、出版する

リクエストから店頭までの予測可能なパス

構造化カタログの読み取り、制御された部分更新、および Peak PIM アプリと同じマルチストア公開ワークフローを使用します。

/商品を取得

ゲット /v1/商品
?検索=アルパイン
&store=fr
&status=ドラフト

200 · 24 件の結果
1/3 ページ

クエリ

商品のコンテキスト全体を読む

商品、バリアント、コレクション、メディア、メタフィールド定義を検索およびフィルターし、マスターデータを取得してバージョンをまとめて保存します。

パッチ /products/:id

パッチ /ストア/フランス
If-Match: リビジョン 42

タイトル：「ヴェステ・アルパイン」

200 · リビジョン-43
ステータス: ドラフト

アップデート

意図したとおりのレイヤーにパッチを適用します

フィールド検証、ドラフトファースト動作、スコープ付きベアラートークン、および古い書き込みを拒否するリビジョンチェックを使用して、マスターデータまたは 1 つのストアバージョンを更新します。

投稿/公開

1検証するマスター + バージョン2発行するアメリカ・フランス・ドイツ3同期バリアント + メディアPeak パイプラインを通じて完了

発行する

1 つのマルチストアパイプラインを使用する

Peak PIM がアプリと同じワークフローを通じてバリアント、メディア、コレクションメンバーシップを調整しながら、接続されている 1 つ、複数、またはすべてのストアに公開します。

統合用に構築

生産カタログ作業に必要なコントロール

API は、統合が安全に失敗できるように、権限、リビジョン、ドラフト、公開を明示的にします。

さらに詳しく

統一された商品モデル

クライアント側でそれらの関係を再構築するのではなく、マスター商品情報とストアごとのバージョンを 1 つの構造化された応答で読み取ります。

ディープリードと正確なクエリ

全文検索、フィルタ、並べ替え、ページネーション、および関連レコードを使用して、統合に実際に必要なコンテキストを取得します。

安全な部分アップデート

スコープは、読み取り、書き込み、および公開アクセスを分離します。オプティミスティック同時実行では、古いリビジョンを黙って受け入れるのではなく、競合が返されます。

明示的な Shopify 公開

公開リクエストが目的のストアをターゲットにするまで、書き込みは下書きのままとなり、カタログの変更はストアフロントのリリースから切り離されます。

よくある質問

開発者が Peak PIM API を使用してビルドする前に知っておくべきすべてのこと。

Peak PIM API では何を構築できますか?

カタログ統合、サプライヤーと ERP 接続、内部商品ツール、自動化、レポート作成、および Peak PIM のマルチストアカタログへの構造化されたアクセスを必要とするその他のワークフローを構築できます。

どのカタログリソースが利用可能ですか?

API は、商品、バリアント、コレクション、メディア、メタフィールド定義、マスターデータ、ストア固有のバージョンを対象とし、検索、フィルタリング、並べ替え、ページネーション、および関連レコードの読み取りを行います。

他のストアを変更せずに 1 つの Shopify ストアを更新できますか?

はい。変更が 1 つのストアフロントに属する場合はストア固有のバージョンにパッチを適用し、共有商品レイヤーで適用する必要がある場合はマスターデータにパッチを適用します。

出版はどのように行われますか?

パブリッシュは、書き込み後の明示的なアクションです。接続されている 1 つ、複数、またはすべてのストアをターゲットにし、Peak PIM は関連するバリアント、メディア、コレクションメンバーシップを使用して Shopify パブリッシングパイプラインを通じて変更を実行します。

API のアクセス範囲はどのように設定されますか?

ベアラー資格情報は個別の pim:read、pim:write、および pim:publish スコープを使用するため、統合は必要な機能のみを受け取ります。削除範囲はありません。

同時更新はどのように処理されますか?

更新リクエストにはレコードのリビジョンが含まれます。別の変更によってそのリビジョンが進んでいる場合、Peak PIM は HTTP 409 で古い書き込みを拒否するため、クライアントは意図的に更新して解決できます。

API を更新すると、すぐに Shopify が変更されますか?

いいえ。更新はドラフトファーストです。クライアントは、検証された変更を選択したストアフロントで使用できるようになると、別の公開リクエストを送信します。

API ドキュメントにはどこからアクセスできますか?

公開開発者ドキュメントには、API リファレンス、認証ガイダンス、エンドポイントの詳細が含まれています (https://developers.peak-pim.com/)。

API ドキュメントを表示する

API は AI コネクタ (MCP) とどのように関連していますか?

AI コネクタ (MCP) は、リモート MCP サーバー上で、入力された会話ツールと同じカタログ機能を公開します。カスタムソフトウェアには REST API を使用するか、既製の AI アシスタントがインターフェイスの場合はコネクタを使用します。

まだ質問がありますか?

私たちのチームにご連絡ください。適切な設定を見つけるお手伝いをいたします。

ご相談ください