الانتقال إلى المحتوى الرئيسي

حالات الاستخدام

استكشف السيناريوهات الشائعة المدعومة من خطة تخزين الكائنات:

استضافة الملفات

فواتير العملاء بناءً على إجمالي استخدام التخزين وحجم التحميل.

خدمات النسخ الاحتياطي

تتبع تحميلات بيانات النسخ الاحتياطي وفرض رسوم لكل جيجابايت مخزنة.

شبكة توصيل الوسائط

مراقبة تحميلات الوسائط وفوترة التخزين وعرض النطاق الترددي.

إدارة الوثائق

تتبع تحميلات الوثائق لكل عميل لأسعار قائمة على الاستخدام.
مثالي للفوترة بناءً على تحميلات التخزين، استضافة الملفات، استخدام CDN، أو خدمات النسخ الاحتياطي.

البداية السريعة

تتبع تحميلات تخزين الكائنات مع البايتات المستهلكة:
1

تثبيت SDK

npm install @dodopayments/ingestion-blueprints
2

احصل على مفاتيح API الخاصة بك

3

إنشاء عداد

قم بإنشاء عداد في لوحة معلومات مدفوعات دودي:
  • اسم الحدث: object_storage_upload (أو الاسم المفضل لديك)
  • نوع التجميع: sum لتتبع إجمالي البايتات المحملة
  • على خاصية: bytes للفوترة بناءً على حجم التخزين
4

تتبع استخدام التخزين

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

التكوين

تكوين الاستيعاب

apiKey
string
required
مفتاح API الخاص بك من لوحة معلومات مدفوعات دودي.
environment
string
required
وضع البيئة: test_mode أو live_mode.
eventName
string
required
اسم الحدث الذي يتطابق مع تكوين العداد الخاص بك.

خيارات تتبع تخزين الكائنات

customerId
string
required
معرف العميل لفوترة النسبة.
bytes
number
عدد البايتات المحملة. مطلوب للفوترة بناءً على البايتات.
metadata
object
بيانات وصفية اختيارية حول التحميل مثل اسم الدلو، نوع المحتوى، إلخ.

أفضل الممارسات

تتبع قبل أو بعد التحميل: يمكنك تتبع الحدث قبل أو بعد التحميل الفعلي اعتمادًا على استراتيجية معالجة الأخطاء الخاصة بك.
التعامل مع فشل التحميل: تتبع فقط التحميلات الناجحة لتجنب الفوترة عن العمليات الفاشلة.