Chuyển đến nội dung chính

Các Trường Hợp Sử Dụng

Khám phá các kịch bản phổ biến được hỗ trợ bởi Kế Hoạch Lưu Trữ Đối Tượng:

File Hosting

Hóa đơn khách hàng dựa trên tổng mức sử dụng lưu trữ và dung lượng tải lên.

Backup Services

Theo dõi việc tải lên dữ liệu sao lưu và tính phí theo GB được lưu trữ.

Media CDN

Giám sát việc tải phương tiện và tính phí cho lưu trữ và băng thông.

Document Management

Theo dõi việc tải tài liệu theo từng khách hàng để định giá dựa trên mức sử dụng.
Hoàn hảo cho việc tính phí dựa trên tải lên lưu trữ, lưu trữ tệp, sử dụng CDN hoặc dịch vụ sao lưu.

Bắt Đầu Nhanh

Theo dõi việc tải lên lưu trữ đối tượng với số byte đã tiêu thụ:
1

Install the SDK

npm install @dodopayments/ingestion-blueprints
2

Get Your API Keys

  • Dodo Payments API Key: Lấy nó từ Dodo Payments Dashboard
  • Storage Provider API Key: Từ AWS S3, Google Cloud Storage, Azure, v.v.
3

Create a Meter

Tạo một meter trong Dodo Payments Dashboard:
  • Event Name: object_storage_upload (hoặc tên tùy chọn của bạn)
  • Aggregation Type: sum để theo dõi tổng số byte đã tải lên
  • Over Property: bytes để tính phí dựa trên kích thước lưu trữ
4

Track Storage Usage

import { Ingestion, trackObjectStorage } from '@dodopayments/ingestion-blueprints';
import { S3Client, PutObjectCommand } from '@aws-sdk/client-s3';
import fs from 'fs';

const ingestion = new Ingestion({
  apiKey: process.env.DODO_PAYMENTS_API_KEY,
  environment: 'test_mode',
  eventName: 'object_storage_upload'
});

const s3 = new S3Client({ region: 'us-east-1' });

// Read the file (example: from disk or request)
const fileBuffer = fs.readFileSync('./document.pdf');

// Upload to S3
const command = new PutObjectCommand({
  Bucket: 'my-bucket',
  Key: 'uploads/document.pdf',
  Body: fileBuffer
});

await s3.send(command);

// Track the upload
await trackObjectStorage(ingestion, {
  customerId: 'customer_123',
  bytes: fileBuffer.length
});

Cấu Hình

Cấu Hình Nhập Dữ Liệu

apiKey
string
bắt buộc
Khóa API Dodo Payments của bạn từ bảng điều khiển.
environment
string
bắt buộc
Chế độ môi trường: test_mode hoặc live_mode.
eventName
string
bắt buộc
Tên sự kiện khớp với cấu hình meter của bạn.

Theo Dõi Tùy Chọn Lưu Trữ Đối Tượng

customerId
string
bắt buộc
Mã định danh khách hàng cho việc phân bổ hóa đơn.
bytes
number
Số byte đã tải lên. Cần thiết cho việc tính phí theo byte.
metadata
object
Siêu dữ liệu tùy chọn về lần tải lên như tên bucket, loại nội dung, v.v.

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

Track Before or After Upload: Bạn có thể theo dõi sự kiện trước hoặc sau khi tải lên tùy thuộc vào chiến lược xử lý lỗi của bạn.
Handle Upload Failures: Chỉ theo dõi các lần tải lên thành công để tránh tính phí cho các thao tác không thành công.