> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# イベント取り込み
> アプリケーションから使用状況イベントを送信して、顧客の消費を追跡し、請求を行います。
イベントは使用量ベースの請求の基盤です。請求可能なアクションが発生したときにイベントを送信し、メーターがそれらを集計して料金にします。
例とレスポンスコードを含む完全なAPIドキュメント。
## イベント構造
一意の識別子。UUIDを使用するか、顧客ID＋タイムスタンプ＋アクションを組み合わせてください。
Dodo Paymentsの顧客ID。有効な既存の顧客である必要があります。
メーターのイベント名と一致するイベントタイプ（大文字小文字を区別）。例: `api.call`、`image.generated`
ISO 8601タイムスタンプ。省略するとサーバー時刻がデフォルトになります。遅延/バッチイベントでは正確な課金のために含めてください。
集計やフィルタリング用の追加プロパティ:
* 数値: `bytes`、`tokens`、`duration_ms`
* フィルタ: `endpoint`、`method`、`quality`
```javascript theme={null}
metadata: {
endpoint: "/v1/orders",
method: "POST",
tokens: 1024
}
```
## イベントの送信
```javascript Single Event theme={null}
await fetch('https://test.dodopayments.com/events/ingest', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.DODO_PAYMENTS_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
events: [{
event_id: "api_call_1234",
customer_id: "cus_abc123",
event_name: "api.call",
metadata: { endpoint: "/v1/orders" }
}]
})
});
```
```javascript Batch Events theme={null}
await fetch('https://test.dodopayments.com/events/ingest', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.DODO_PAYMENTS_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
events: [
{ event_id: "call_1", customer_id: "cus_abc", event_name: "api.call" },
{ event_id: "call_2", customer_id: "cus_abc", event_name: "api.call" },
{ event_id: "call_3", customer_id: "cus_abc", event_name: "api.call" }
]
})
});
```
```python Python theme={null}
import requests
requests.post(
'https://test.dodopayments.com/events/ingest',
headers={'Authorization': f'Bearer {api_key}', 'Content-Type': 'application/json'},
json={'events': [{'event_id': 'call_1', 'customer_id': 'cus_abc', 'event_name': 'api.call'}]}
)
```
```curl cURL theme={null}
curl -X POST 'https://test.dodopayments.com/events/ingest' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"events": [{"event_id": "call_1", "customer_id": "cus_abc", "event_name": "api.call"}]}'
```
パフォーマンス向上のため、リクエストごとに最大1,000件のイベントを一括処理します。APIは1回のコールにつき、1,000件のイベントのハードリミットを強制します。
## 取り込みブループリント
一般的なユースケースのための既製のイベントパターン。ゼロから構築するのではなく、実績のあるブループリントから始めましょう。
OpenAI、Anthropic、Groq、GeminiなどのAIトークン使用量を追跡します。
エンドポイントフィルタリングとレート制限に対応したMeter APIリクエストを測定します。
クラウドストレージサービス向けにファイルアップロードとストレージ消費量を追跡します。
ビデオ、オーディオ、リアルタイムデータのストリーミング帯域幅を計測します。
サーバーレス関数やコンピュートインスタンスの経過時間に基づいて課金します。
詳細な実装ガイド付きの利用可能なブループリントをすべて確認できます。
## ベストプラクティス
重複を防ぐために決定論的なIDを使用してください: `${customerId}_${action}_${timestamp}`
5xxエラー時には指数バックオフでリトライしてください。4xxエラーはリトライしないでください。
リアルタイムイベントでは省略してください。遅延/バッチイベントでは正確性のために含めてください。
成功率を追跡し、失敗したイベントを再試行用にキューイングします。
## トラブルシューティング
* イベント名はメーターと完全一致させてください（大文字小文字を区別）
* 顧客IDが存在することを確認してください
* メーターのフィルタがイベントを除外していないか確認してください
* タイムスタンプが最近のものであることを確認してください
APIキーが正しいことを確認し、形式を使用してください: `Bearer YOUR_API_KEY`
必要なフィールドがすべて含まれていることを確認してください: `event_id`、`customer_id`、`event_name`
* メタデータキーはメーターの「Over Property」と完全に一致させてください
* 文字列ではなく数値を使用してください: `tokens: 150`（`tokens: "150"`ではありません）
## 次のステップ
フィルタと集計関数を使ってイベントが課金対象の数量にどのように集計されるかを定義します。
LLMトラッキング、APIゲートウェイ、ストレージなどの一般的なユースケース向けの既製ブループリントを利用してください。
使用量ベースの課金を備えた完全なAI画像ジェネレーターをゼロから構築します。
すべてのパラメーター、レスポンスコード、およびインタラクティブテストを含む完全なAPIドキュメント。