トレカクラウド 外部連携API

店舗が許可した外部アプリのためのAPIです。OAuth 2.1 の認可コードフロー（PKCE S256）で受け取ったアクセストークンを、Authorization: Bearer で付けて呼びます。どの店舗の情報を扱うかはトークンで決まります。

すべての応答に Cache-Control: no-store が付きます。エラーは { "error": "コード" } の形です。

接続

店舗との接続を作る・確かめる・やめる操作です。どちらかの読み取り権限で呼べます。

• GET
  接続を確かめる/connection
• POST
  接続を作る/connection
• DELETE
  接続をやめる/connection

買取強化対象

店舗が通常より高く買い取るカードやBOXの一覧です。purchase-boosts:read で読めます。

• GET
  買取強化対象の一覧を取得する/purchase-boosts

在庫

拠点・保管場所・在庫の個体の同期です。inventory:read が必要です。

• GET
  拠点と保管場所を取得する/inventory/sites
• GET
  在庫の変更を読む/inventory/changes
• GET
  個体の写真を取得する/inventory/items/{id}/photos/{side}

カードマスタ

トレカクラウドのカードマスタの検索です。inventory:read が必要です。

• GET
  カードマスタを検索する/cards
• GET
  カードを1件取得する/cards/{id}

変更通知

在庫が変わったことを知らせるWebhookの登録です。inventory:read が必要です。

• PUT
  Webhookを登録する/webhook
• DELETE
  Webhookを消す/webhook