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

ほかの Drime ユーザーが自分のアカウントに接続する OAuth アプリケーションを作成し、Webhook や Drime Sign のイベント通知をサーバーで受け取ります。

更新日：2026-10-19  
出典：https://drime.cloud/ja/support/integrations-and-api/build-an-integration

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

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

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

![開発者ポータルの「アプリケーションを作成」フォーム。3種類のアプリケーションが並んでいる](https://drime.cloud/media/01M5AT6DMNDAVYH6SJW5CDQYFB/8439d64a4ecd-web-developers-create-application.png)

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

| 選択肢 | 用途 |
| --- | --- |
| **ウェブサイトまたはサーバー** | サーバーで保管するシークレットキーが発行されます。 |
| **デスクトップまたはモバイルアプリ** | ユーザーのデバイスにインストールされるため、シークレットキーはありません。 |
| **自分用のスクリプト** | 自分で実行する小さなツールです。 |

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

知っておきたいこと：

- アプリケーションは25個まで作成できます。
- 新しいアプリケーションを使えるのは、25人のユーザーまでです。さらに多くのユーザーに公開するには、**全員に公開する**を選んでから**審査に送る**をクリックします。Drime から24時間以内に回答があります。
- アクセストークンの有効期間は1時間、リフレッシュトークンの有効期間は90日です。
- サードパーティのアプリケーションが Vault にアクセスすることはできません。

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

## Drime Sign の Webhook

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

- ドキュメントが送信、完了、または辞退されたとき
- 署名者がドキュメントを閲覧、署名、または辞退したとき
- テンプレートが作成されたとき

![開発者の設定の「Webhook」セクション。「Webhook を追加」がある](https://drime.cloud/media/01M5AKQ8TWF4KP6TWB0GPD9RK7/f4d9572805b0-web-sign-webhooks.png)

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

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

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

## 次のステップ

- [API トークンを作成する](https://drime.cloud/ja/support/integrations-and-api/api-tokens)
- [Rclone、Drime CLI、WebDAV](https://drime.cloud/ja/support/integrations-and-api/rclone-cli-and-webdav)