OAuthスコープ

APIでできることを。権限。

スコープは階層的です。つまり、readにアクセスできる場合、read:accountsは自動的に適用されます。アプリケーションはユーザーに対してできるだけ少ない要求を行うようにすべきです

複数のスコープを同時に要求できます。パラメーターを使用してアプリを作成するときscopes、OAuthで認証するときはscopeクエリパラメーターを使用します(スコープをスペースで区切ります)。

注意 scopeとscopesの違いに気をつけてください。scopeは標準的なOAuthのパラメーター名でOAuthメソッド中はこれを使いますが、MastodonのAPIではより適切なscopesが用いられます。

scopeが認証時に無かったり、scopesがアプリケーション登録時に無い場合はreadとして扱われます。

アプリの作成中に保存されるスコープのセットには、認証リクエストでリクエストするすべてのスコープが含まれている必要があります。そうでない場合、認証は失敗します。

0.9.0 - read, write, follow
2.4.0 - push
2.4.3 - 詳細なスコープ(:以下のスコープ) https://github.com/tootsuite/mastodon/pull/7929
2.6.0 - read:reportsを削除 (unused stub) https://github.com/tootsuite/mastodon/pull/8736/commits/adcf23f1d00c8ff6877ca2ee2af258f326ae4e1f
2.6.0 - write:conversationsスコープを追加 https://github.com/tootsuite/mastodon/pull/9009
2.9.1 - Admin関連スコープを追加 https://github.com/tootsuite/mastodon/pull/9387
3.1.0 - Bookmark関連スコープを追加

スコープ一覧

データの読み取りを許可します。readはread:*を意味します。read:~と書いてあるものが全て許可されます。

データの変更を許可します。writeはwrite:*を意味します。write:~と書いてあるものが全て許可されます。

フォロー関係を読み取り、変更できます。followはfollow:*を意味します。follow:~と書いてあるものが全て許可されます。

Web Push APIの購読を許可します。Mastodon 2.4.0で追加されました。

モデレーションAPIのために使用されます。Mastodon 2.9.1で追加されました。以下の:1階層スコープを許容します。つまりadminというスコープはなく、admin:readとadmin:writeが独立して存在します。

admin:read	admin:write
admin:read:accounts	admin:write:accounts
admin:read:reports	admin:write:reports

最終更新 March 4, 2020 · このページを改善する
他の言語: English