> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Account Activity API

> Webhook を通じてアカウントアクティビティのリアルタイムイベントを受信する

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

Account Activity API は、アカウントアクティビティに関するイベントをリアルタイムで webhook に送信します。ユーザーアカウントを購読すると、そのユーザーがポストしたとき、DM を受信したとき、フォローされたときなどに通知を受け取ることができます。

<div id="overview">
  ## 概要
</div>

<CardGroup cols={2}>
  <Card title="Webhook 配信" icon="webhook">
    イベントをサーバーに配信
  </Card>

  <Card title="リアルタイム" icon="bolt">
    即時のイベント通知
  </Card>

  <Card title="包括的" icon="list">
    投稿、DM、フォロー、いいねなど
  </Card>

  <Card title="サブスクリプション型" icon="bell">
    ユーザーアカウントを購読
  </Card>
</CardGroup>

***

<div id="how-it-works">
  ## 仕組み
</div>

1. **Webhook を登録** — Webhook URL を登録します
2. **ユーザーをサブスクライブ** — ユーザーのサブスクリプションを追加します
3. **イベントを受信** — POST リクエストでアクティビティイベントを受信します
4. **イベントを処理** — アプリケーションでイベントを処理します

***

<div id="event-types">
  ## イベント種別
</div>

| カテゴリ           | イベント                |
| :------------- | :------------------ |
| **投稿**         | 作成、削除、いいね、いいね解除     |
| **ダイレクトメッセージ** | 受信、送信、入力中インジケーターの表示 |
| **フォロー**       | フォロー、フォロー解除         |
| **ブロック**       | ブロック、ブロック解除         |
| **ミュート**       | ミュート、ミュート解除         |

***

<div id="webhook-security">
  ## Webhook のセキュリティ
</div>

すべての Webhook リクエストには次のものが含まれます。

* **CRC 検証** — Webhook の正当性を検証します
* **署名ヘッダー** — `x-twitter-webhooks-signature`
* **HTTPS 必須** — すべての Webhook URL は HTTPS を使用する必要があります

***

<div id="example-register-a-webhook">
  ## 例：webhook を登録する
</div>

```bash theme={null}
curl -X POST "https://api.x.com/1.1/account_activity/all/env-name/webhooks.json?\
url=https%3A%2F%2Fyour-server.com%2Fwebhook" \
  -H "Authorization: OAuth oauth_consumer_key=..."
```

***

<div id="getting-started">
  ## 開始方法
</div>

<Note>
  **前提条件**

  * 承認済みの[開発者アカウント](https://developer.x.com/en/portal/petition/essential/basic-info)
  * 開発者コンソール内の [Project と App](/ja/resources/fundamentals/developer-apps)
  * 外部からアクセス可能な HTTPS webhook エンドポイント
</Note>

<CardGroup cols={2}>
  <Card title="アクティビティストリーム" icon="stream" href="/ja/x-api/activity/introduction">
    webhook に代わるストリーミング方式
  </Card>

  <Card title="移行ガイド" icon="right-left" href="/ja/x-api/account-activity/migrate/overview">
    v1.1 からの移行
  </Card>

  <Card title="APIリファレンス" icon="code" href="/ja/x-api/account-activity/register-webhook">
    エンドポイントに関する詳細なドキュメント
  </Card>
</CardGroup>