Vai al contenuto principale

Casi d’Uso

Esplora scenari comuni supportati dal Blueprint di Archiviazione Oggetti:

File Hosting

Addebitare i clienti in base all’utilizzo totale di archiviazione e al volume di upload.

Backup Services

Traccia gli upload dei dati di backup e addebita per GB archiviato.

Media CDN

Monitora gli upload multimediali e fattura per archiviazione e larghezza di banda.

Document Management

Traccia gli upload di documenti per cliente per tariffe basate sull’utilizzo.
Perfetto per la fatturazione basata sugli upload di archiviazione, hosting di file, utilizzo CDN o servizi di backup.

Avvio Veloce

Monitora i caricamenti di archiviazione oggetti con i byte consumati:
1

Install the SDK

npm install @dodopayments/ingestion-blueprints
2

Get Your API Keys

  • Dodo Payments API Key: Ottienilo da Dodo Payments Dashboard
  • Storage Provider API Key: Da AWS S3, Google Cloud Storage, Azure, ecc.
3

Create a Meter

Crea un contatore nel tuo Dodo Payments Dashboard:
  • Event Name: object_storage_upload (o il nome che preferisci)
  • Aggregation Type: sum per tracciare il totale di byte caricati
  • Over Property: bytes per fatturare in base alle dimensioni di archiviazione
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
});

Configurazione

Configurazione di Ingestione

apiKey
string
obbligatorio
La tua chiave API Dodo Payments dal pannello di controllo.
environment
string
obbligatorio
Modalità ambiente: test_mode o live_mode.
eventName
string
obbligatorio
Nome dell’evento che corrisponde alla configurazione del tuo contatore.

Opzioni di Monitoraggio dell’Archiviazione Oggetti

customerId
string
obbligatorio
L’ID cliente per l’attribuzione della fatturazione.
bytes
number
Numero di byte caricati. Richiesto per la fatturazione basata sui byte.
metadata
object
Metadati opzionali sull’upload come il nome del bucket, il tipo di contenuto, ecc.

Migliori Pratiche

Traccia Prima o Dopo l’Upload: puoi tracciare l’evento prima o dopo l’upload effettivo a seconda della tua strategia di gestione degli errori.
Gestisci i Fallimenti degli Upload: traccia solo gli upload riusciti per evitare di fatturare operazioni fallite.