Shopify APIとは:Admin API・Storefront APIの違いと使い方入門

Shopify APIとは:Admin API・Storefront APIの違いと使い方入門

| 更新日
LESSON 14Shopify基礎講座段階:カスタマイズ・開発読む時間の目安:約11分対象:Shopifyのカスタマイズ・アプリ連携に関心がある運営者(非エンジニア可)
管理画面のデータが矢印を通じて外部のアプリ・システムとつながる様子
Shopifyのデータは、API(アプリケーション間の窓口)を通じて外部のアプリやシステムとやり取りされる

この記事で分かること

  • Shopifyが提供するAPI(Admin API・Storefront API等)が、それぞれ何のためにあるか
  • トークンを使った認証の、ごく基本的な考え方
  • 自分でコードを書かなくても、API連携の話が出てきたときに迷わないための見取り図

この回はエンジニア向けの実装手順書ではありません。Shopifyのカスタマイズやアプリ連携を検討するときに「APIという言葉が何を指しているか」が分かる状態を目指します。コード例は最小限にとどめ、全体像を優先します。

01API(アプリケーション・プログラミング・インターフェース)とは

用語メモ | API

Application Programming Interface(アプリケーション・プログラミング・インターフェース)の略。異なるソフトウェア同士が、人間の画面操作を介さずにデータをやり取りするための「窓口」です。

Shopify管理画面で商品を登録したり注文を確認したりする操作は、人間がブラウザの画面を通じて行います。APIは、この同じデータのやり取りを、プログラム同士が直接行えるようにする仕組みです。たとえば「外部の在庫管理システムから、Shopifyの在庫数を自動で更新する」「予約注文があった顧客にだけ、別システムから案内メールを送る」といった連携は、APIを通じて実現します。

02Shopifyが提供する主なAPI

Shopifyは用途ごとに複数のAPIを公式開発者ドキュメントで公開しています(2026年10月時点で確認)。

ストアのデータにつながるAdmin API・Storefront API・Customer Account APIと、別の性質を持つWebhooks・Shopify Functions・Partner APIを分けて示した図
図1:用途ごとに窓口(API)が分かれている
API 主な用途
GraphQL Admin API 商品・顧客・注文・在庫など、管理画面の裏側にあるデータの読み書き
Storefront API 商品一覧・カートなどを含む、独自のストアフロント(お客様が見るお店の画面)を作るための基本機能。ReactベースのフレームワークHydrogenの基盤にもなっている
Customer Account API 顧客のアカウント情報・注文履歴へのアクセス
Webhooks ストアでデータが変わったとき(注文が入った等)に、外部のアプリへ通知する仕組み
Shopify Functions チェックアウト中の処理(割引・配送・支払い方法の表示・カートやチェックアウト内容の検証など)を、独自のコードで変える仕組み
Partner API Partner Dashboard(アプリ開発者・制作会社向けの管理画面)にある、組織や支払いなどのデータへのアクセス。ストアの商品や注文のデータではない

運営者としてまず押さえておきたいのは、「管理画面の裏側を操作するAdmin API」と「独自のストアフロントを作るためのStorefront API」は役割が違うという点です。既存のテーマをカスタマイズする範囲であればAdmin APIやStorefront APIを直接触る場面は少なく、お店の画面をテーマに頼らず独自に作る(ヘッドレスコマースと呼ばれる構成)場合にStorefront APIが土台になります。

03GraphQLとREST:今はGraphQLが基本

用語メモ | GraphQL

データの取得・更新方法を指定する問い合わせ言語の一種。必要な項目だけを指定して、過不足なくデータを取得できるのが特徴です。

Shopifyの開発者ドキュメント(REST Admin API)では、REST Admin APIについて「2024年10月1日時点でレガシー(legacy、旧式)API」と説明されています。さらに、2025年4月1日以降は新規の公開アプリをGraphQL Admin APIのみで構築する必要があるともされています。新しいプラットフォーム機能がGraphQLだけに提供される場合もあると説明されており、これから何かを作る・依頼するのであれば、GraphQL Admin APIが基本という位置づけです。

GraphQLには、REST(よく使われるもう一つの方式)と違う特徴もあります。公式ドキュメントには、本来であれば4xx・5xxのエラーになる場面でも200 OK(正常応答)が返ることがあると説明されています。アクセス回数の制限も、リクエストの「件数」ではなく、クエリの複雑さに応じた「コスト(ポイント)」で計算される仕組みです。

ここがポイント

  • これから新しくAPI連携を依頼するなら、GraphQL Admin APIが基本
  • RESTのような単純なリクエスト数の制限ではなく、クエリごとのコストで利用量が決まる

もっとも単純な例を挙げると、商品を10件取得するクエリは products(first: 10) { nodes { id title } } のような形です。first: 10 で「最初の10件」を指定し、その下に取得したい項目(id・title)を並べる、という考え方です。コードを書くのは開発者の仕事ですが、「欲しい項目だけを指定して取る」という発想自体は覚えておくと、依頼内容を伝えるときに役立ちます。

04認証:誰が・どうやってアクセス許可を得るか

APIを呼び出すには、トークン(アクセス許可の証明)が必要です。公式ドキュメント(認証と認可)では、トークンをX-Shopify-Access-Tokenというヘッダーに入れて呼び出すこと、トークンに付与された範囲(スコープ)がアクセスできるデータの範囲を決めることが説明されています。

自社専用のカスタムアプリと、他ストアにも配布する公開アプリの認証フローの違いを示す図
図2:カスタムアプリと公開アプリでは、トークンの取得経路が違う

認証の経路は、アプリの性質によって変わります。

アプリの種類 想定される用途 トークンの取得経路
カスタムアプリ 自社(同じ組織内)のストアだけで使う連携 クライアントID・シークレットによる直接取得(マーチャントの承認操作は不要)
公開アプリ(管理画面内・埋め込み) 他のストアにも配布するアプリ マーチャントのIDトークンをアクセストークンに交換する方式
公開アプリ(管理画面外) 他のストアにも配布する、外部で動くアプリ マーチャントをShopifyの承認画面に移動させ、戻ってきたコードをトークンに交換する方式(認可コードグラント)

補足

Shopify CLIで作られたアプリは、インストール時の承認処理がある程度自動化されているため、上記のような認可の流れを開発者が一から実装する必要はないと説明されています。自社専用か、他社にも配布するアプリかで、必要な手続きが変わる、という大枠だけ押さえておけば十分です。

補足

以前は、Shopify管理画面の「設定 > アプリと販売チャネル > アプリを開発」から自社専用のカスタムアプリを作れました。公式ドキュメントでは、この管理画面で作るカスタムアプリは「新しく作ることはできなくなった(既存のものは引き続き保守できる)」と説明されています。Shopify開発者コミュニティの告知によると、新規作成ができなくなったのは2026年1月1日以降です。現在のカスタムアプリは開発者向けの管理画面(Dev Dashboard)で作成・管理すると、公式ヘルプ(アプリについて)に記載されています。古い解説記事の手順どおりに進めようとしても、その画面からは作れない点に注意が必要です。

05どんな場面でAPIが使われるか

API連携という言葉が出てくる代表的な場面を整理します。

  • 外部システムとの自動連携:会計ソフト・在庫管理システム・CRM(顧客管理システム)などとデータを自動で同期する
  • 独自のストアフロントの構築:既存テーマの範囲を超えて、お店の画面(商品一覧・カートなど)を独自に作る(Storefront APIが土台)
  • 業務の自動化:注文が入ったら外部システムに知らせる、といった処理を自動で行う(データ変更を検知するWebhooksや、ノーコードで自動化できる公式アプリShopify Flowを使う)
  • チェックアウトの処理を変える:独自の割引ルールや、条件に応じた配送・支払い方法の出し分けなどを組み込む(Shopify Functionsを使う)
  • アプリ開発:Shopify App Storeで配布するアプリを作る(主にGraphQL Admin APIと、管理画面やチェックアウトに機能を追加する拡張機能を使う)

自分でコードを書かない運営者であっても、外部ツールの営業資料や開発会社への依頼で「このAPIに対応しています」「GraphQLで連携します」といった言葉が出てきたら、この回で触れた区分けを思い出せれば十分です。

06まとめ

ここがポイント

  • Shopifyには用途ごとに複数のAPIがあり、「管理画面の裏側を操作するAdmin API」と「独自のストアフロントを作るStorefront API」の違いがまず押さえどころ
  • 現在新しく作るなら基本はGraphQL Admin API。REST Admin APIは2024年10月時点でレガシー扱いとされている
  • 認証の方法は、自社専用のカスタムアプリか、他社にも配布する公開アプリかで変わる。管理画面から新しいカスタムアプリを作ることはできなくなっている

理解度チェック

質問をクリックすると答えが開きます

Q1. 既存のテーマをカスタマイズする範囲を超えて、お店の画面(ストアフロント)を独自に作りたい場合、土台になるAPIはどれですか?

Storefront APIです。ReactベースのフレームワークHydrogenの基盤にもなっています。

Q2. 現在、新しく公開アプリを作る場合に基本となるAPIはどちらですか?

GraphQL Admin APIです。REST Admin APIは2024年10月時点でレガシー扱いとされ、2025年4月以降は新規の公開アプリをGraphQL Admin APIのみで構築する必要があるとされています。

Q3. 自社のストア専用に使うカスタムアプリと、他ストアにも配布する公開アプリでは、何が違いますか?

トークンの取得経路です。カスタムアプリ(同じ組織内のストアだけで使うもの)はマーチャントの承認操作なしで直接トークンを取得できますが、公開アプリはマーチャントの承認を伴うOAuthフローでトークンを取得します。