Vai al contenuto principale

Casi d’Uso

Esplora scenari comuni supportati dal Blueprint di Archiviazione Oggetti:

Hosting di File

Fattura i clienti in base all’utilizzo totale dello storage e al volume di caricamento.

Servizi di Backup

Monitora i caricamenti di dati di backup e addebita per GB memorizzati.

Media CDN

Monitora i caricamenti di media e fattura per storage e larghezza di banda.

Gestione Documenti

Monitora i caricamenti di documenti per cliente per una tariffazione basata sull’utilizzo.
Perfetto per la fatturazione basata sui caricamenti di storage, hosting di file, utilizzo di CDN o servizi di backup.

Avvio Veloce

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

Installa l'SDK

npm install @dodopayments/ingestion-blueprints
2

Ottieni le tue Chiavi API

  • Chiave API di Dodo Payments: Ottienila dal Dashboard di Dodo Payments
  • Chiave API del Fornitore di Storage: Da AWS S3, Google Cloud Storage, Azure, ecc.
3

Crea un Meter

Crea un meter nel tuo Dashboard di Dodo Payments:
  • Nome Evento: object_storage_upload (o il tuo nome preferito)
  • Tipo di Aggregazione: sum per monitorare il totale dei byte caricati
  • Su Proprietà: bytes per fatturare in base alla dimensione dello storage
4

Monitora l'Utilizzo dello Storage

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 di Dodo Payments dal dashboard.
environment
string
obbligatorio
Modalità ambiente: test_mode o live_mode.
eventName
string
obbligatorio
Nome evento che corrisponde alla configurazione del tuo meter.

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
Metadata opzionali sul caricamento come nome del bucket, tipo di contenuto, ecc.

Migliori Pratiche

Monitora Prima o Dopo il Caricamento: Puoi monitorare l’evento prima o dopo il caricamento effettivo a seconda della tua strategia di gestione degli errori.
Gestisci i Fallimenti di Caricamento: Monitora solo i caricamenti riusciti per evitare di fatturare operazioni fallite.