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:

Lưu Trữ Tệp

Tính phí khách hàng dựa trên tổng mức sử dụng lưu trữ và khối lượng tải lên.

Dịch Vụ Sao Lưu

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

CDN Phương Tiện

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

Quản Lý Tài Liệu

Theo dõi việc tải lên tài liệu theo từng khách hàng để tính phí dựa trên mức sử dụng.
Hoàn hảo cho việc tính phí dựa trên việc 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

Cài Đặt SDK

npm install @dodopayments/ingestion-blueprints
2

Lấy API Keys Của Bạn

3

Tạo Một Đồng Hồ

Tạo một đồng hồ trong Bảng Điều Khiển Dodo Payments:
  • Tên Sự Kiện: object_storage_upload (hoặc tên bạn chọn)
  • Loại Tập Hợp: sum để theo dõi tổng số byte đã tải lên
  • Trên Tài Sản: bytes để tính phí dựa trên kích thước lưu trữ
4

Theo Dõi Mức Sử Dụng Lưu Trữ

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
required
API key Dodo Payments của bạn từ bảng điều khiển.
environment
string
required
Chế độ môi trường: test_mode hoặc live_mode.
eventName
string
required
Tên sự kiện phù hợp với cấu hình đồng hồ của bạn.

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

customerId
string
required
ID khách hàng để ghi nhận hóa đơn.
bytes
number
Số byte đã tải lên. Cần thiết cho việc tính phí dựa trên byte.
metadata
object
Siêu dữ liệu tùy chọn về việc tải lên như tên bucket, loại nội dung, v.v.

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

Theo Dõi Trước Hoặc Sau Khi Tải Lên: Bạn có thể theo dõi sự kiện trước hoặc sau khi tải lên thực tế tùy thuộc vào chiến lược xử lý lỗi của bạn.
Xử Lý Các Lỗi Tải Lên: Chỉ theo dõi các tải lên thành công để tránh tính phí cho các thao tác thất bại.