アプリを開発する・Webhook を接続する

自分のアカウントで Drime API を使うだけなら、個人用のトークンで十分です。API トークンを作成するをご覧ください。ほかの Drime ユーザーが自分のアカウントに接続するアプリを開発するには、OAuth アプリケーションを作成します。ユーザーは Drime 上でアプリを承認し、アプリがユーザーのパスワードを知ることはありません。

#OAuth アプリケーションを作成する

サインインしているユーザーなら誰でも、開発者ポータルのマイアプリケーションでアプリケーションを作成をクリックして、アプリケーションを作成できます。

最初に、何を開発するかを選びます。

次に、アプリケーションに必要なアクセス範囲を選びます。専用のフォルダ（ドライブに作成される1つのフォルダだけにアクセスします）または Drive 全体です。

知っておきたいこと：

• アプリケーションは25個まで作成できます。

• 新しいアプリケーションを使えるのは、25人のユーザーまでです。さらに多くのユーザーに公開するには、全員に公開するを選んでから審査に送るをクリックします。Drime から24時間以内に回答があります。

• アクセストークンの有効期間は1時間、リフレッシュトークンの有効期間は90日です。

• サードパーティのアプリケーションが Vault にアクセスすることはできません。

ウェブサイトまたはサーバーのアプリケーションは、接続したアカウントでファイルが作成または削除されたときに、Webhook を受け取ることもできます。各通知には、X-Drime-Signature ヘッダーで署名が付きます。

#Drime Sign の Webhook

設定 > 開発者 > Webhook（Drime Sign のイベントを HTTP で通知します。）で Webhook を追加をクリックすると、たとえば次のようなときにサーバーに通知が届きます。

• ドキュメントが送信、完了、または辞退されたとき

• 署名者がドキュメントを閲覧、署名、または辞退したとき

• テンプレートが作成されたとき

各通知には、シークレットで署名が付きます（X-Drime-Signature、HMAC SHA-256）。送信に失敗した通知は、約34時間にわたって最大10回再送されます。テスト送信、鍵を再生成、配信履歴の確認もできます。

#ウェブサイトに署名フォームを埋め込む

設定 > 開発者 > 埋め込みで、<drime-sign-form> ウィジェットを使って、訪問者がウェブサイトを離れずにドキュメントに署名できるようにします。許可するドメインにドメインを追加してください。ドメインが1つもない場合、埋め込みは無効になります。

#次のステップ

• API トークンを作成する

• Rclone、Drime CLI、WebDAV