イベント取り込み

イベントは使用量ベースの請求の基盤です。請求可能なアクションが発生したときにイベントを送信し、メーターがそれらを集計して料金にします。

API Reference — Events Ingestion

例とレスポンスコードを含む完全なAPIドキュメント。

イベント構造

Required Fields

string

必須

リトライ時に重複イベントを検出するために使用する、イベントの一意の識別子です。アクションから導出してください。たとえば、顧客ID + アクション + タイムスタンプのようにすると、リトライされたイベントでも同じIDが維持されます。リトライごとに新しいランダムなUUIDを生成すると、同じイベントが2回カウントされます。

string

必須

Dodo Paymentsの顧客IDです。既存の有効な顧客である必要があります。

string

必須

メーターのイベント名と一致するイベントタイプです（大文字と小文字を区別）。例：api.call、image.generated。

Optional Fields

string

ISO 8601形式のタイムスタンプ（UTC）です。省略した場合は、現在のサーバー時刻がデフォルトで使用されます。遅延イベントやバッチイベントを正確に請求するには、この値を含めてください。1時間より古いタイムスタンプ、または5分を超えて未来のタイムスタンプは拒否されます。

object

集計およびフィルタリング用の追加プロパティ。最大50個のキーを指定でき、各キーは最大100文字、各値は最大500文字です。

数値: bytes、tokens、duration_ms
フィルター: endpoint、method、quality

metadata: {
  endpoint: "/v1/orders",
  method: "POST",
  tokens: 1024
}

イベントの送信

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" }
    }]
  })
});

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" }
    ]
  })
});

import os
import requests

requests.post(
    'https://test.dodopayments.com/events/ingest',
    headers={'Authorization': f"Bearer {os.environ['DODO_PAYMENTS_API_KEY']}", 'Content-Type': 'application/json'},
    json={'events': [{'event_id': 'call_1', 'customer_id': 'cus_abc', 'event_name': 'api.call'}]}
)

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回のリクエストにつき最大1,000件のイベントをバッチ処理できます。APIでは、1回のリクエストにつき1,000件のイベントというハードリミットが適用されます。

取り込みブループリント

一般的なユースケースのための既製のイベントパターン。ゼロから構築するのではなく、実績のあるブループリントから始めましょう。

LLM Blueprint

OpenAI、Anthropic、Groq、GeminiなどのAIトークン使用量を追跡します。

API Gateway Blueprint

エンドポイントフィルタリングとレート制限に対応したMeter APIリクエストを測定します。

Object Storage Blueprint

クラウドストレージサービス向けにファイルアップロードとストレージ消費量を追跡します。

Stream Blueprint

ビデオ、オーディオ、リアルタイムデータのストリーミング帯域幅を計測します。

Time Range Blueprint

サーバーレス関数やコンピュートインスタンスの経過時間に基づいて課金します。

View All Blueprints

詳細な実装ガイド付きの利用可能なブループリントをすべて確認できます。

ベストプラクティス

Use Unique Event IDs

重複を防ぐには決定論的なIDを使用してください：${customerId}_${action}_${timestamp}。

Implement Retries

5xxおよび429エラーの場合は、指数バックオフを使用してリトライしてください。その他の4xxエラーはリトライしないでください。

Include Timestamps

リアルタイムイベントではタイムスタンプを省略してください。遅延イベントやバッチイベントでは、正確性を確保するためにタイムスタンプを含めてください。

Monitor Delivery

成功率を追跡し、失敗したイベントを再試行用にキューイングします。

トラブルシューティング

Events not appearing

イベント名はメーターと完全に一致している必要があります（大文字と小文字を区別）
顧客IDがアカウントに存在している必要があります
メーターのフィルターによってイベントが除外されていないことを確認してください
タイムスタンプが新しいことを確認してください

Authentication errors (401)

APIキーが正しいことを確認し、次の形式を使用してください：Bearer YOUR_API_KEY。

Validation errors (400)

必要なすべてのフィールドが存在することを確認してください：event_id、customer_id、event_name。

Metadata not aggregating

メタデータキーは、メーターの「Over Property」と完全に一致している必要があります
文字列ではなく数値を使用してください：tokens: 150であり、tokens: "150"ではありません

次のステップ

Create Meters

フィルタと集計関数を使ってイベントが課金対象の数量にどのように集計されるかを定義します。

Ingestion Blueprints

LLMトラッキング、APIゲートウェイ、ストレージなどの一般的なユースケース向けの既製ブループリントを利用してください。

Complete Tutorial

使用量ベースの課金を備えた完全なAI画像ジェネレーターをゼロから構築します。

API Reference

すべてのパラメーター、レスポンスコード、およびインタラクティブテストを含む完全なAPIドキュメント。

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

API Reference — Events Ingestion

イベント構造

イベントの送信

取り込みブループリント

LLM Blueprint

API Gateway Blueprint

Object Storage Blueprint

Stream Blueprint

Time Range Blueprint

View All Blueprints

ベストプラクティス

トラブルシューティング

次のステップ

Create Meters

Ingestion Blueprints

Complete Tutorial

API Reference

API Reference — Events Ingestion

​イベント構造

​イベントの送信

​取り込みブループリント

LLM Blueprint

API Gateway Blueprint

Object Storage Blueprint

Stream Blueprint

Time Range Blueprint

View All Blueprints

​ベストプラクティス

​トラブルシューティング

​次のステップ

Create Meters

Ingestion Blueprints

Complete Tutorial

API Reference

イベント構造

イベントの送信

取り込みブループリント

ベストプラクティス

トラブルシューティング

次のステップ