権限とエラー

外部連携APIの権限（scope）の一覧と、エラーの形と意味をまとめています。

権限（scope）

トークンには、読み取りの権限（inventory:read か purchase-boosts:read）が少なくとも1つ必要です。どちらもないトークンは、どのエンドポイントでも拒否されます。

権限は、店舗が連携先を登録するときに選びます。登録で許可されていない権限を認可のときに求めると、invalid_scope で拒否されます。

エラーの形

エラーは { "error": "コード" } の形で返ります。権限が足りないときは、足りない権限も添えます。

{ "error": "insufficient_scope", "scope": "inventory:read" }

このときは WWW-Authenticate ヘッダーにも、足りない権限と保護リソースのメタデータのURLが入ります。

主なエラー