Chuyển đến nội dung chính
Các sự kiện là nền tảng của lập hóa đơn dựa trên mức sử dụng. Gửi sự kiện khi các hành động có thể tính phí xảy ra, và các công tơ sẽ tổng hợp chúng thành các khoản phí.

API Reference - Events Ingestion

Tài liệu API hoàn chỉnh với các ví dụ và mã phản hồi.

​
Cấu Trúc Sự Kiện

​
event_id
string
bắt buộc
Định danh duy nhất. Sử dụng UUID hoặc kết hợp ID khách hàng + dấu thời gian + hành động.
​
customer_id
string
bắt buộc
ID khách hàng Dodo Payments. Phải là khách hàng hợp lệ đang tồn tại.
​
event_name
string
bắt buộc
Loại sự kiện khớp với tên sự kiện của đồng hồ đo của bạn (phân biệt chữ hoa chữ thường). Ví dụ: api.call, image.generated
​
timestamp
string
Dấu thời gian ISO 8601. Mặc định sử dụng giờ máy chủ nếu bỏ qua. Bao gồm để đảm bảo hóa đơn chính xác với các sự kiện trì hoãn/ghép.
​
metadata
object
Thuộc tính bổ sung để tổng hợp và lọc:
  • Giá trị số: bytes, tokens, duration_ms
  • Bộ lọc: endpoint, method, quality
metadata: {
  endpoint: "/v1/orders",
  method: "POST",
  tokens: 1024
}

​
Gửi Sự Kiện

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" }
    }]
  })
});
Gộp tối đa 100 sự kiện cho mỗi yêu cầu để cải thiện hiệu suất.

​
Mẫu Tiếp Nhận

Các mẫu sự kiện đã được chuẩn bị sẵn cho các trường hợp sử dụng phổ biến. Bắt đầu với một mẫu đã được chứng minh thay vì xây dựng từ đầu.

LLM Blueprint

Theo dõi việc sử dụng token AI trên OpenAI, Anthropic, Groq, Gemini và hơn thế nữa.

API Gateway Blueprint

Đo lượng yêu cầu API với lọc đầu cuối và hỗ trợ giới hạn tốc độ.

Object Storage Blueprint

Theo dõi việc tải lên tệp và mức tiêu thụ lưu trữ cho dịch vụ lưu trữ đám mây.

Stream Blueprint

Đo băng thông truyền phát cho video, âm thanh và dữ liệu thời gian thực.

Time Range Blueprint

Hóa đơn theo thời gian trôi qua cho các hàm serverless và phiên bản tính toán.

View All Blueprints

Xem tất cả các bản mẫu có sẵn cùng hướng dẫn triển khai chi tiết.

​
Thực Hành Tốt Nhất

Sử dụng ID xác định để tránh trùng lặp: ${customerId}_${action}_${timestamp}
Thử lại khi gặp lỗi 5xx với đệm tăng theo cấp số nhân. Không thử lại lỗi 4xx.
Bỏ qua đối với các sự kiện thời gian thực. Bao gồm đối với các sự kiện trì hoãn/ghép để đảm bảo độ chính xác.
Theo dõi tỷ lệ thành công và đưa các sự kiện thất bại vào hàng đợi để thử lại.

​
Khắc Phục Sự Cố

  • Tên sự kiện phải khớp chính xác với đồng hồ đo (phân biệt chữ hoa chữ thường)
  • ID khách hàng phải tồn tại
  • Kiểm tra xem các bộ lọc của đồng hồ đo có đang loại trừ sự kiện không
  • Xác minh dấu thời gian gần đây
Xác minh khóa API đúng và sử dụng định dạng: Bearer YOUR_API_KEY
Đảm bảo tất cả các trường bắt buộc đều có: event_id, customer_id, event_name
  • Các khóa metadata phải khớp chính xác với “Thuộc tính vượt quá” của đồng hồ đo
  • Sử dụng số, không phải chuỗi: tokens: 150 chứ không phải tokens: "150"

​
Các Bước Tiếp Theo

Create Meters

Xác định cách các sự kiện của bạn được tổng hợp thành các đơn vị tính phí với bộ lọc và hàm tổng hợp.

Ingestion Blueprints

Sử dụng các bản mẫu sẵn sàng cho các trường hợp phổ biến như theo dõi LLM, cổng API và lưu trữ.

Complete Tutorial

Xây dựng một trình tạo hình ảnh AI đầy đủ với thanh toán theo mức sử dụng từ đầu.

API Reference

Tài liệu API hoàn chỉnh với tất cả tham số, mã phản hồi và kiểm tra tương tác.
Last modified on March 3, 2026