メルカリShops APIの使い方

メルカリShops APIは、メルカリShopの作業を自動化するツールを開発することができるGraphQLのAPI。API連携という申請をしないと利用できないため、APIを利用して自動化したい場合は、API連携しているシステムを提供しているサービスを利用するしかない。

「API連携」しているシステムを提供しているサービス一覧

メルカリShops APIでは、下記のようなことが可能。

• 商品の登録、更新、削除、参照
• 商品在庫の登録、更新、参照
• 注文の完了処理、キャンセル、参照
• 取引メッセージの追加、参照
• Webhookによる注文イベントのリアルタイム受信

APIドキュメント

メルカリShopsのGraphQL APIのドキュメント

こんな感じでリクエストする。GraphQLなので、リクエストにjsonキーでjsonスキーマの文字列を指定する。

import requests
import json

AccessToken = '****************************************************'
url = "https://api.mercari-shops.com/v1/graphql"
headers = {
    "Authorization": "Bearer %s"%AccessToken,
    "Content-Type": "application/json",
    "User-Agent": "myapp/0.0.0"
}

query = """
query shop {
  shop {
    businessKind
    createdAt
    description
    id
    name
  }
}
"""

response = requests.post(url, headers=headers, json={"query": query})

if response.status_code == 200:
    print(response.json())
else:
    print('API Error:', response.status_code, response.text)

APIキー取得方法

1. メルカリShopsの管理画面へログインし、[設定]をクリックします
   メルカリShopsの管理画面
2. [APIアクセストークンの発行]をクリックします
3. トークン名へ「GoQSystem」と入力し、[トークンを発行する]をクリックします
4. 3で発行されたトークンをコピーします
   ※トークンは発行直後のみコピーできます。一度でもリロード/画面遷移をするとコピーできなくなるため、忘れずにコピーしてください。
   ※トークンは10個まで作成できます。10個を超える場合は古いものを削除したり、すでに発行したものを再利用する等で対応してください