API トークンを作成する

API トークンを使うと、rclone などのスクリプトやツールが、パスワードなしで Drime アカウントにアクセスできます。トークンごとにできることを選べ、いつでも無効にできます。

個人用のトークンは、自分のアカウントで動かすスクリプト、バックアップ、ツールのためのものです。ほかの Drime ユーザーが自分のアカウントに接続するアプリは OAuth を使い、ユーザーにパスワードを求めてはいけません。Drime API のドキュメントをご覧ください。

#トークンを作成する

1. 右上のアバターをクリックし、設定をクリックします。

2. 開発者をクリックします。

3. API アクセストークンでトークンを作成をクリックします。

   

4. トークン名に、見分けやすい名前を入力します。

   トークンを使うツールやパソコンがわかる名前にします（例：「NAS の rclone」）。名前は3文字以上100文字以下にしてください。

5. 権限で、トークンにできることを選びます。

   • すべて：すべてのリソースにフルアクセスできます。

   • 読み取り専用：すべてのリソースを読み取り専用で利用できます。

   • 制限付き：選んだリソースにだけアクセスでき、リソースごとにアクセス権なし、既読、書き込みのいずれかを設定します。

   適切な権限を選ぶをご覧ください。

   

6. 作成をクリックします。

7. コピーをクリックしてトークンをコピーし、完了をクリックします。

   トークンがクリップボードにコピーされると、ボタンにコピーしました！ と表示されます。

   

作成したトークンは API アクセストークンに表示され、すぐに使えます。有効期限はなく、削除するまで使えます。

#適切な権限を選ぶ

トークンには、必要な権限だけを与えてください。

制限付きのトークンには、ファイル（バージョンとゴミ箱を含む）、フォルダ、共有、ワークスペース、Vault、署名、ホワイトボード、ファイルリクエスト、Send & Track、連絡先、タグ、アナリティクスのリソースが並びます。アナリティクス（ストレージの使用量）は読み取りしかできないため、選択肢はアクセス権なしとアクセスです。リソースの横にあるヘルプアイコンにカーソルを合わせると、そのリソースの対象範囲が表示されます。

アカウント、セキュリティ、請求の設定にアクセスできるのは、すべてのトークンだけです。読み取り専用と制限付きのトークンは、これらの設定には一切アクセスできません。

トークンの権限は、作成後に変更できません。変更するには、適切な権限で新しいトークンを作成し、ツールの設定を更新してから、古いトークンを削除します。

#トークンを使う

すべてのリクエストで、トークンを Authorization ヘッダーに入れて送信します。

Authorization: Bearer YOUR_ACCESS_TOKEN

API アクセストークンの横にあるドキュメントのリンクをクリックすると、Drime API のドキュメントが開きます。rclone でトークンを使う方法は、Rclone、Drime CLI、WebDAVをご覧ください。

#トークンを確認・削除する

API アクセストークンには、自分で作成したトークンと、Drime のアプリ（Drime Desktop、Drime Mobile、ブラウザ拡張機能）が自動で作成したトークンが一覧表示されます。各行には次の情報が表示されます。

• トークンの名前、またはアプリとそのプラットフォーム（例：デスクトップアプリ · Windows）

• 権限（例：すべてのアクセス権）

• 最後に使われた日時、または未使用

トークンが1つもない場合は、個人アクセストークンはまだありませんと表示されます。

トークンを無効にするには、次の手順で操作します。

1. トークンの行の右端にあるトークンを削除（ゴミ箱のアイコン）をクリックします。

   

2. 削除をクリックして確定します。

   ダイアログには、このトークンは直ちに完全に削除されます。削除すると、API リクエストには使用できなくなります。 という警告が表示されます。削除するとトークンを削除しましたと表示され、そのトークンを使っているツールはすぐに動かなくなります。

Drime のアプリは、セッションとデバイスを確認してログアウトするの手順でログアウトさせることもできます。

#うまくいかない場合

#次のステップ

• Rclone、Drime CLI、WebDAV

• セッションとデバイスを確認してログアウトする