楽天市場・ZOZOTOWN・ShopifyのデータをそれぞれAPIで取得しようとすると何が大変なのか

はじめに: 「APIでつなげばいい」という言葉の重さ

複数モールのデータをBIツールで見るには、まずどこかにデータを集約する必要がある。その手段として真っ先に思い浮かぶのが「各モールのAPIを使ってデータを取得する」という方法だ。ただし実際にやってみると、モールごとにAPIの仕様がまったく異なり、「1つのAPIを覚えれば残りも応用できる」というわけにはいかないことに気づく。

楽天市場: 申込制で、独自の認証方式とXML形式

楽天市場には出店者向けの「楽天RMS」上から申し込む形でWEB APIが提供されている。商品情報の取得・在庫の一括更新・受注情報の取得など、EC運営に必要な主要機能はひと通り揃っているが、利用開始には楽天RMSへのログイン後に個別申込と規約同意の手続きが必要で、誰でもすぐ使えるわけではない。認証も「サービスシークレット」と「ライセンスキー」という楽天独自の2つの鍵をコロンで結合しBase64エンコードしてヘッダーに付与する独自方式だ。レスポンス形式もAPIによって統一されておらず、古くからあるAPI群にはXML(SOAP)形式が残る一方、受注検索・受注取得など比較的新しいAPIはJSON形式で実装されているケースが確認できる。1つの形式に統一されているAdmin API型のサービスと違い、利用するAPIごとに形式を個別に確認する必要がある点も、実装の負荷を上げる要因になる。

ZOZOTOWN: 出店者向けの公式外部連携APIは一般公開されていない

一方ZOZOTOWNについては、出店ブランドが受注・在庫データを外部システム側から取得するための公式API仕様は、一般公開された情報としては見当たらない。ZOZO公式のテックブログで確認できるのは「ZOZOBASE出荷データ連携API」で、これは出店ブランド側が商品・出荷情報をZOZO側へ送信するための仕組みであり、逆方向(ZOZOTOWN側から受注・在庫データを取得する)の一般公開APIとは別物だ。受注一元管理システム各社のヘルプページには「ZOZOTOWNとAPIで連携するには個別申請が必要」といった記載が見られるが、これがZOZO側の公開仕様に基づくものか、システム提供会社とZOZOの間の個別の取り決めなのかは、外部の情報だけでは判別できない。

Shopify: 自社の管理画面から自分で発行できるAdmin API

対照的にShopifyでは、ストア管理画面上でカスタムアプリを作成するだけで、そのストア専用のアクセストークンをオーナー自身がその場で発行できる。外部への申込や審査を挟まずに開発を始められる点が、楽天RMSやZOZOTOWNとの大きな違いだ。データ形式も、現在Shopifyが移行を推奨しているGraphQL Admin APIではJSONが基本となり、受注・在庫・商品などほぼすべての管理画面相当のデータを取得できる。

「モールが増えるほど、覚える仕様の数も増える」という構造

この表が示す通り、モールが1つ増えるということは、単に「データソースが1つ増える」だけでなく、「認証方式・データ形式・申込手続きがまったく異なる仕組みを、もう1つ理解して実装する」ことを意味する。3モールなら3通り、それぞれ別のクセを持つ仕様と向き合う必要がある。

自前実装だけが選択肢ではない

この複雑さを踏まえると、全モールのAPIを自社で実装しきる以外にも、対応コネクタを持つノーコードのデータ連携サービスを使う、あるいは受注一元管理システムにすでに集約されたデータを活用するという選択肢がある。それぞれの向き・不向きは次の記事で扱う。

よくある質問